Intercom icon

Intercom

Consume Intercom API
Join our community

Actions10

Overview

The Intercom node for n8n allows you to interact with the Intercom API. Specifically, when using the Company resource and the Get operation, this node retrieves information about a company in your Intercom workspace based on a selected property (such as Company ID, Intercom ID, or Name). This is useful for automating workflows that need to fetch company details for enrichment, reporting, or further processing.

Practical examples:

  • Automatically look up company details by their unique identifier when a new event occurs.
  • Enrich CRM records with company data from Intercom.
  • Validate if a company exists in Intercom before performing other actions.

Properties

Name Type Meaning
Select By options Determines which property to use for querying the company. Options: Company ID, ID, Name.
Value string The value corresponding to the selected property (e.g., the actual Company ID or Name).

Output

The output will be a JSON object containing the company details as returned by the Intercom API. The structure may include fields such as:

{
  "type": "company",
  "id": "123456",
  "company_id": "my-company-id",
  "name": "Acme Inc.",
  "created_at": 1234567890,
  "updated_at": 1234567890,
  "remote_created_at": 1234567890,
  "industry": "Software",
  "website": "https://acme.com",
  "monthly_spend": 1000,
  "plan": "Pro",
  "size": 50,
  "custom_attributes": {
    "key1": "value1"
  }
  // ...other fields depending on your Intercom setup
}

If the query does not match any company, the response may be an empty array or an error message.

Dependencies

  • External Service: Requires access to the Intercom API.
  • Credentials: You must configure intercomCredentialsApi in n8n with your Intercom API key/token.

Troubleshooting

Common issues:

  • Invalid credentials: If your API key is incorrect or missing, you'll receive authentication errors.
  • No matching company found: If the provided value does not correspond to any company, the result may be empty or return an error.
  • Rate limits: Excessive requests to the Intercom API may result in rate limiting.

Error messages:

  • "Intercom Error: {...}": Indicates an error response from the Intercom API. Check the error details for more information (e.g., invalid parameters, not found).
  • "Cannot read property '...' of undefined": May occur if the expected field is missing in the response; ensure the input values are correct.

How to resolve:

  • Double-check your API credentials.
  • Ensure the "Value" matches the format required by the selected "Select By" option.
  • Review Intercom API documentation for field requirements and limitations.

Links and References

Discussion