Overview
The Intercom node for n8n allows you to interact with the Intercom API, specifically to manage company records.
For the Company → Update operation, this node updates an existing company's details in your Intercom workspace.
Typical use cases include synchronizing company data from other systems (like CRMs or ERPs), updating company attributes based on user actions, or automating enrichment of company profiles.
Example scenarios:
- Automatically update a company's plan or size when a customer upgrades.
- Enrich company profiles with new custom attributes from another database.
- Keep company website and industry information up-to-date.
Properties
| Name | Type | Meaning |
|---|---|---|
| Company ID | String | The unique identifier you have defined for the company in Intercom. |
| JSON Parameters | Boolean | If true, custom attributes are provided as raw JSON; if false, they are entered as key/value pairs. |
| Additional Fields | Collection | Optional standard fields to update, such as Industry, Monthly Spend, Name, Plan, Size, Website. |
| Custom Attributes | JSON | (If JSON Parameters is true) A JSON object of custom key/value pairs to attribute to the company. |
| Custom Attributes | FixedCollection | (If JSON Parameters is false) Key/value pairs representing custom attributes for the company. |
Additional Fields options:
- 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 associated with the company.
- Size (Number): The number of employees in the company.
- Website (String): The URL for the company's website (not validated).
Output
The output will be a JSON object representing the updated company as returned by the Intercom API.
The structure typically includes:
{
"type": "company",
"id": "...",
"company_id": "...",
"name": "...",
"plan": "...",
"size": ...,
"website": "...",
"industry": "...",
"monthly_spend": "...",
"custom_attributes": {
"key1": "value1",
"key2": "value2"
},
...
}
- All updated fields will be reflected in the response.
- Any custom attributes provided will appear under
custom_attributes.
Dependencies
- External Service: Requires access to the Intercom API.
- API Credentials: You must configure valid Intercom API credentials (
intercomCredentialsApi) in n8n. - n8n Configuration: No special environment variables required beyond credential setup.
Troubleshooting
Common Issues:
- Invalid Company ID: If the provided Company ID does not exist in Intercom, the node will throw an error.
- Malformed JSON: If using JSON Parameters for custom attributes, invalid JSON will cause a validation error.
- Missing Required Fields: Omitting the Company ID will result in an error, as it is mandatory for updates.
- API Authentication Errors: Incorrect or missing API credentials will prevent successful requests.
Error Messages:
"Intercom Error: {...}": Indicates an error response from the Intercom API. Check the message for details (e.g., invalid field, authentication failure)."Cannot parse JSON parameter": Occurs if the custom attributes JSON is malformed. Ensure valid JSON syntax.
How to resolve:
- Double-check the Company ID exists in your Intercom account.
- Validate any JSON input before submitting.
- Ensure all required credentials are correctly configured in n8n.