Intercom Tools

Intercom is a customer messaging and support platform. These tools let a workflow manage Intercom contacts (users and leads) — creating new contacts, paging through the full contact list, fetching a single contact by ID, and searching contacts by a field query. Use them to sync customer records, look up contact details mid-workflow, or enrich downstream steps with Intercom data.

Overview

Operations

Configuration

intercom_create_contact

intercom_list_contacts

intercom_get_contact

intercom_search_contacts

Outputs

intercom_create_contact

• data (json) — The created Intercom contact object.
• metadata (json) — Contact identifiers. Properties:
  • id (string) — Contact ID.
  • type (string) — Object type.

intercom_list_contacts

• data (json) — Array of Intercom contact objects.
• metadata (json) — List metadata. Properties:
  • count (number) — Number of items returned.
  • total_count (number) — Total number of contacts.

intercom_get_contact

• data (json) — The Intercom contact object.
• metadata (json) — Contact identifiers. Properties:
  • id (string) — Contact ID.
  • type (string) — Object type.

intercom_search_contacts

• data (json) — Array of matching Intercom contact objects.
• metadata (json) — List metadata. Properties:
  • count (number) — Number of items returned.
  • total_count (number) — Total number of matching contacts.

YAML Example

intercom_1:
  type: intercom
  name: "Intercom"
  inputs:
    operation: "intercom_create_contact"
    role: "user"
    email: "jane@example.com"
    name: "Jane Doe"
    phone: "+15551234567"
    apiKey: "{{INTERCOM_API_KEY}}"
  connections:
    outgoing:
      - target: next-block-id

Tips

• Auth setup: Generate an access token in the Intercom Developer Hub (Settings → Developers → your app → Authentication). Store it as an environment variable and reference it with {{INTERCOM_API_KEY}} rather than hardcoding the secret. All requests pin Intercom-Version: 2.11.
• Pagination: intercom_list_contacts is cursor-based. Set per_page (max 150) and pass the last contact ID into starting_after on the next call to page through large contact lists.
• Search syntax: intercom_search_contacts runs a single-field query — set field, operator, and value (e.g. field: email, operator: =, value: jane@example.com). The ~ operator does a contains/partial match. Both list and search return an array under {{intercom_1.data}}, while get/create return a single object — index accordingly in downstream blocks.