Overview
The Intercom node for n8n allows you to interact with the Intercom API, specifically to manage companies and contacts.
For the Company → Create operation, this node enables you to create a new company record in your Intercom workspace, including standard fields (like name, website, industry) and custom attributes.
Common scenarios:
- Automatically add new companies to Intercom when they are created in your CRM or another system.
- Enrich company data in Intercom with additional information from other sources.
- Batch import companies into Intercom as part of onboarding or migration processes.
Example:
When a new customer signs up on your platform, use this node to create a corresponding company in Intercom, setting its name, website, industry, and any custom attributes relevant to your business.
Properties
| Name | Type | Meaning |
|---|---|---|
| Company ID | String | The unique identifier you have defined for the company. |
| JSON Parameters | Boolean | If true, custom attributes are provided as raw JSON; if false, use UI fields for key/values. |
| Additional Fields | Collection | Optional standard company fields such as Industry, Monthly Spend, Name, Plan, Size, Website. |
| Custom Attributes | JSON | (If JSON Parameters is true) Key/value pairs for custom company data, entered as raw JSON. |
| Custom Attributes | FixedCollection | (If JSON Parameters is false) Key/value pairs for custom company data, entered via UI. |
Additional Fields options:
| Field | Type | Meaning |
|---|---|---|
| Industry | String | The industry that this company operates in. |
| Monthly Spend | String | The monthly spend associated with the company. |
| Name | String | The name of the company. |
| Plan | String | The plan name associated with the company. |
| Size | Number | The number of employees in the company. |
| Website | String | The company's website URL (not validated). |
Output
The output will be a JSON object representing the newly created company as returned by the Intercom API.
Typical fields include (but are not limited to):
{
"type": "company",
"id": "123456",
"company_id": "your-company-id",
"name": "Acme Inc.",
"industry": "Software",
"monthly_spend": "1000",
"plan": "Premium",
"size": 50,
"website": "https://acme.com",
"custom_attributes": {
"key1": "value1",
"key2": "value2"
},
...
}
- All fields sent in the request (standard and custom) will be reflected in the response, along with Intercom-generated metadata (such as
id,created_at, etc.).
Dependencies
- External Service: Requires an Intercom account and access to the Intercom API.
- API Credentials: You must configure Intercom API credentials (
intercomCredentialsApi) in n8n. - n8n Configuration: No special environment variables required beyond credential setup.
Troubleshooting
Common issues:
- Missing or invalid Company ID: The
Company IDfield is required. Ensure it is unique and correctly formatted. - Invalid JSON in Custom Attributes: If using JSON input for custom attributes, ensure the JSON is valid. Invalid JSON will cause the node to fail.
- API Authentication Errors: If credentials are missing or incorrect, you'll receive authentication errors from Intercom.
- Field Validation Errors: Some fields may have restrictions (e.g., size must be a number). Check error messages for details.
Error messages:
"Intercom Error: ...": Indicates an error returned by the Intercom API. Review the message for specifics (e.g., duplicate company ID, invalid field)."Cannot parse JSON parameter": Means the custom attributes JSON is malformed. Validate your JSON before submitting.
How to resolve:
- Double-check all required fields.
- Use a JSON validator for custom attributes.
- Ensure your Intercom credentials are correct and have sufficient permissions.