Intercom icon

Intercom

Consume Intercom API

Actions10

Company → Get

AI-generated

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