Intercom

Connect your own Intercom workspace by saving its private-app Access Token, after checking it actually works against your chosen data region. Get a token from Intercom: Developer Hub > your app > Configure > Authentication.

Disconnect an Intercom workspace: deletes the saved Access Token. Nothing in Intercom itself is changed.

List the connected Intercom workspaces.

List contacts (people and leads) in the connected Intercom workspace, cursor-paginated.

Read one contact in full, including emails/phones/tags/companies and activity timestamps.

Create a new contact (user or lead) with email/phone/external_id/name.

Update selected fields of an existing contact. Only given fields change.

Permanently delete a contact. Cannot be undone through the API.

Attach an existing tag to a contact by tag id.

Remove a tag from a contact by tag id.

Attach a contact to a company by company id.

Remove a contact from a company.

List the companies a contact belongs to.

List companies in the connected Intercom workspace.

Read one company in full, including user/session counts and plan.

Create a new company, or update an existing one if company_id already exists (Intercom upserts by company_id).

Permanently delete a company. Cannot be undone.

List the contacts belonging to one company.

List conversations in the connected Intercom workspace, cursor-paginated.

Read one conversation in full: source message, state, assignee, tags, and every conversation part (replies/notes).

Search conversations by a single field/operator/value filter (e.g. state = open, priority = priority).

Reply to a conversation as an admin, either a visible comment or an internal note.

Manage a conversation's lifecycle: close, snooze, reopen, or assign to an admin/team.

Add an internal note to a conversation, visible only to teammates.

List support tickets in the connected Intercom workspace, cursor-paginated.

Read one ticket in full: type, state, description, and linked contact.

Create a new ticket of a given ticket type, raised for a contact.

Update selected fields of an existing ticket (state and/or title). Only given fields change.

Reply to a ticket as an admin, either a visible comment or an internal note.

List ticket types configured on the connected Intercom workspace (e.g. 'Bug Report', 'Feature Request').

Create a new ticket type definition (a custom ticket 'shape' with its own attributes).

List the ticket states configured on the connected Intercom workspace (e.g. Submitted, In Progress, Resolved).

List Help Center articles on the connected Intercom workspace.

Read one Help Center article in full.

Create a new Help Center article, as a draft or published immediately.

Update selected fields of an existing article (title/body/state). Only given fields change.

Permanently delete a Help Center article. Cannot be undone.

List Help Center collections (the top-level folders articles are organized into).

Create a new Help Center collection (a top-level folder or nested sub-collection of articles).

List News items (in-product announcements) on the connected Intercom workspace.

Create a new News item (draft or live) sent from a given admin.

Update selected fields of an existing News item. Only given fields change.

Permanently delete a News item. Cannot be undone.

List admins (teammates) on the connected Intercom workspace.

Read one admin (teammate) in full by id.

Set an admin away or back, optionally reassigning their open conversations.

List teams (groups of admins) on the connected Intercom workspace.

Read one team in full: its name and member admin ids.

List custom/default data attributes defined for contacts, companies, or conversations.

Create a new custom data attribute (field) on contacts or companies.

Track a custom event for a contact (e.g. 'invited-friend', 'completed-onboarding') with optional metadata.

Enqueue a bulk Data Export job for a date range (contacts/conversations archive). Returns a job to poll with get_data_export.

Check the status of a Data Export job and get its download URL once ready.

Enqueue a Reporting Data Export job for a specific dataset/attribute set and date range -- Intercom's newer analytics-grade export.

List the away status reasons admins can select when setting themselves away.

List tags defined on the connected Intercom workspace.

Create a new tag on the connected Intercom workspace.

Permanently delete a tag from the workspace. Removes it from every contact/conversation/company it was attached to.

List segments (dynamic, condition-based contact groups computed by Intercom itself) on the connected workspace.

Read one segment's definition in full by id.

List subscription types (opt-in/opt-out communication categories, e.g. Newsletters, Product Updates) on the workspace.

Opt a contact into a subscription type (e.g. subscribe them to a newsletter category).

Opt a contact out of a subscription type.

Start a new Fin AI Agent conversation on behalf of one of your own end-users, and get Fin's first reply.

Send a follow-up message into an existing Fin AI Agent conversation and get Fin's next reply.

List External Pages -- custom knowledge-source content registered for Fin AI Agent to learn from.

Register a new External Page as a Fin AI Agent knowledge source.

Update an existing External Page's content so Fin AI Agent learns the new version.

Permanently delete an External Page so Fin AI Agent stops using it as a source. Cannot be undone.

List Content Import Sources -- external URLs/sites Fin AI Agent syncs and learns from automatically.

Send a one-off outbound message (in-app or email) from an admin to a contact.

Build one aggregated health report across recent conversations on the connected Intercom workspace: open/unassigned/stale/priority/snoozed counts, so you can spot support backlog at a glance.

Scan recent open conversations and flag every one waiting on a reply for at least a given number of hours -- catches support backlog before customers escalate.