How do I install the Intercom full reference skill?

Run npx skillmds@latest add tools-only/intercom-full-reference-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Intercom full reference skill do?

This is the full reference documentation for the Intercom agent connector. It is listed under Coding & Dev Tools on SkillMD.

Is Intercom full reference safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Intercom full reference?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Intercom full reference free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Intercom full reference?

tools-only (@tools-only) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Intercom full reference by tools-only

Name: Intercom full reference
Author: tools-only

Intercom full reference

This is the full reference documentation for the Intercom agent connector.

Supported entities and actions

The Intercom connector supports the following entities and actions.

Entity	Actions
Contacts	List, Create, Get, Update, Search
Conversations	List, Get, Search
Companies	List, Create, Get, Update, Search
Teams	List, Get, Search
Admins	List, Get
Tags	List, Create, Get
Notes	Create
Segments	List, Get
Internal Articles	Create

Contacts

Contacts List

Returns a paginated list of contacts in the workspace

Python SDK

await intercom.contacts.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "contacts",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`per_page`	`integer`	No	Number of contacts to return per page
`starting_after`	`string`	No	Cursor for pagination - get contacts after this ID

Records

Field Name	Type	Description
`type`	`string \| null`
`id`	`string`
`workspace_id`	`string \| null`
`external_id`	`string \| null`
`role`	`string \| null`
`email`	`string \| null`
`phone`	`string \| null`
`name`	`string \| null`
`avatar`	`string \| null`
`owner_id`	`integer \| null`
`social_profiles`	`object \| any`
`has_hard_bounced`	`boolean \| null`
`marked_email_as_spam`	`boolean \| null`
`unsubscribed_from_emails`	`boolean \| null`
`created_at`	`integer \| null`
`updated_at`	`integer \| null`
`signed_up_at`	`integer \| null`
`last_seen_at`	`integer \| null`
`last_replied_at`	`integer \| null`
`last_contacted_at`	`integer \| null`
`last_email_opened_at`	`integer \| null`
`last_email_clicked_at`	`integer \| null`
`language_override`	`string \| null`
`browser`	`string \| null`
`browser_version`	`string \| null`
`browser_language`	`string \| null`
`os`	`string \| null`
`location`	`object \| any`
`android_app_name`	`string \| null`
`android_app_version`	`string \| null`
`android_device`	`string \| null`
`android_os_version`	`string \| null`
`android_sdk_version`	`string \| null`
`android_last_seen_at`	`integer \| null`
`ios_app_name`	`string \| null`
`ios_app_version`	`string \| null`
`ios_device`	`string \| null`
`ios_os_version`	`string \| null`
`ios_sdk_version`	`string \| null`
`ios_last_seen_at`	`integer \| null`
`custom_attributes`	`object \| null`
`tags`	`object \| any`
`notes`	`object \| any`
`companies`	`object \| any`

Field Name	Type	Description
`next_page`	`string \| null`

Contacts Create

Create a new contact (user or lead)

Python SDK

await intercom.contacts.create(
    role="<str>",
    external_id="<str>",
    email="<str>",
    phone="<str>",
    name="<str>",
    avatar="<str>",
    signed_up_at=0,
    last_seen_at=0,
    owner_id=0,
    unsubscribed_from_emails=True,
    custom_attributes={}
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "contacts",
    "action": "create",
    "params": {
        "role": "<str>",
        "external_id": "<str>",
        "email": "<str>",
        "phone": "<str>",
        "name": "<str>",
        "avatar": "<str>",
        "signed_up_at": 0,
        "last_seen_at": 0,
        "owner_id": 0,
        "unsubscribed_from_emails": True,
        "custom_attributes": {}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`role`	`string`	Yes	The role of the contact (user or lead)
`external_id`	`string`	No	A unique identifier for the contact from your system
`email`	`string`	No	The contact's email address
`phone`	`string`	No	The contact's phone number
`name`	`string`	No	The contact's full name
`avatar`	`string`	No	An image URL for the contact's avatar
`signed_up_at`	`integer`	No	Sign up timestamp (Unix)
`last_seen_at`	`integer`	No	Last seen timestamp (Unix)
`owner_id`	`integer`	No	The ID of the admin assigned as owner
`unsubscribed_from_emails`	`boolean`	No	Whether the contact is unsubscribed from emails
`custom_attributes`	`object`	No	Custom attributes for the contact

Records

Field Name	Type	Description
`type`	`string \| null`
`id`	`string`
`workspace_id`	`string \| null`
`external_id`	`string \| null`
`role`	`string \| null`
`email`	`string \| null`
`phone`	`string \| null`
`name`	`string \| null`
`avatar`	`string \| null`
`owner_id`	`integer \| null`
`social_profiles`	`object \| any`
`has_hard_bounced`	`boolean \| null`
`marked_email_as_spam`	`boolean \| null`
`unsubscribed_from_emails`	`boolean \| null`
`created_at`	`integer \| null`
`updated_at`	`integer \| null`
`signed_up_at`	`integer \| null`
`last_seen_at`	`integer \| null`
`last_replied_at`	`integer \| null`
`last_contacted_at`	`integer \| null`
`last_email_opened_at`	`integer \| null`
`last_email_clicked_at`	`integer \| null`
`language_override`	`string \| null`
`browser`	`string \| null`
`browser_version`	`string \| null`
`browser_language`	`string \| null`
`os`	`string \| null`
`location`	`object \| any`
`android_app_name`	`string \| null`
`android_app_version`	`string \| null`
`android_device`	`string \| null`
`android_os_version`	`string \| null`
`android_sdk_version`	`string \| null`
`android_last_seen_at`	`integer \| null`
`ios_app_name`	`string \| null`
`ios_app_version`	`string \| null`
`ios_device`	`string \| null`
`ios_os_version`	`string \| null`
`ios_sdk_version`	`string \| null`
`ios_last_seen_at`	`integer \| null`
`custom_attributes`	`object \| null`
`tags`	`object \| any`
`notes`	`object \| any`
`companies`	`object \| any`

Contacts Get

Get a single contact by ID

Python SDK

await intercom.contacts.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "contacts",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`id`	`string`	Yes	Contact ID

Records

Field Name	Type	Description
`type`	`string \| null`
`id`	`string`
`workspace_id`	`string \| null`
`external_id`	`string \| null`
`role`	`string \| null`
`email`	`string \| null`
`phone`	`string \| null`
`name`	`string \| null`
`avatar`	`string \| null`
`owner_id`	`integer \| null`
`social_profiles`	`object \| any`
`has_hard_bounced`	`boolean \| null`
`marked_email_as_spam`	`boolean \| null`
`unsubscribed_from_emails`	`boolean \| null`
`created_at`	`integer \| null`
`updated_at`	`integer \| null`
`signed_up_at`	`integer \| null`
`last_seen_at`	`integer \| null`
`last_replied_at`	`integer \| null`
`last_contacted_at`	`integer \| null`
`last_email_opened_at`	`integer \| null`
`last_email_clicked_at`	`integer \| null`
`language_override`	`string \| null`
`browser`	`string \| null`
`browser_version`	`string \| null`
`browser_language`	`string \| null`
`os`	`string \| null`
`location`	`object \| any`
`android_app_name`	`string \| null`
`android_app_version`	`string \| null`
`android_device`	`string \| null`
`android_os_version`	`string \| null`
`android_sdk_version`	`string \| null`
`android_last_seen_at`	`integer \| null`
`ios_app_name`	`string \| null`
`ios_app_version`	`string \| null`
`ios_device`	`string \| null`
`ios_os_version`	`string \| null`
`ios_sdk_version`	`string \| null`
`ios_last_seen_at`	`integer \| null`
`custom_attributes`	`object \| null`
`tags`	`object \| any`
`notes`	`object \| any`
`companies`	`object \| any`

Contacts Update

Update an existing contact by ID

Python SDK

await intercom.contacts.update(
    role="<str>",
    external_id="<str>",
    email="<str>",
    phone="<str>",
    name="<str>",
    avatar="<str>",
    signed_up_at=0,
    last_seen_at=0,
    owner_id=0,
    unsubscribed_from_emails=True,
    custom_attributes={},
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "contacts",
    "action": "update",
    "params": {
        "role": "<str>",
        "external_id": "<str>",
        "email": "<str>",
        "phone": "<str>",
        "name": "<str>",
        "avatar": "<str>",
        "signed_up_at": 0,
        "last_seen_at": 0,
        "owner_id": 0,
        "unsubscribed_from_emails": True,
        "custom_attributes": {},
        "id": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`role`	`string`	No	The role of the contact (user or lead)
`external_id`	`string`	No	A unique identifier for the contact from your system
`email`	`string`	No	The contact's email address
`phone`	`string`	No	The contact's phone number
`name`	`string`	No	The contact's full name
`avatar`	`string`	No	An image URL for the contact's avatar
`signed_up_at`	`integer`	No	Sign up timestamp (Unix)
`last_seen_at`	`integer`	No	Last seen timestamp (Unix)
`owner_id`	`integer`	No	The ID of the admin assigned as owner
`unsubscribed_from_emails`	`boolean`	No	Whether the contact is unsubscribed from emails
`custom_attributes`	`object`	No	Custom attributes for the contact
`id`	`string`	Yes	Contact ID

Records

Field Name	Type	Description
`type`	`string \| null`
`id`	`string`
`workspace_id`	`string \| null`
`external_id`	`string \| null`
`role`	`string \| null`
`email`	`string \| null`
`phone`	`string \| null`
`name`	`string \| null`
`avatar`	`string \| null`
`owner_id`	`integer \| null`
`social_profiles`	`object \| any`
`has_hard_bounced`	`boolean \| null`
`marked_email_as_spam`	`boolean \| null`
`unsubscribed_from_emails`	`boolean \| null`
`created_at`	`integer \| null`
`updated_at`	`integer \| null`
`signed_up_at`	`integer \| null`
`last_seen_at`	`integer \| null`
`last_replied_at`	`integer \| null`
`last_contacted_at`	`integer \| null`
`last_email_opened_at`	`integer \| null`
`last_email_clicked_at`	`integer \| null`
`language_override`	`string \| null`
`browser`	`string \| null`
`browser_version`	`string \| null`
`browser_language`	`string \| null`
`os`	`string \| null`
`location`	`object \| any`
`android_app_name`	`string \| null`
`android_app_version`	`string \| null`
`android_device`	`string \| null`
`android_os_version`	`string \| null`
`android_sdk_version`	`string \| null`
`android_last_seen_at`	`integer \| null`
`ios_app_name`	`string \| null`
`ios_app_version`	`string \| null`
`ios_device`	`string \| null`
`ios_os_version`	`string \| null`
`ios_sdk_version`	`string \| null`
`ios_last_seen_at`	`integer \| null`
`custom_attributes`	`object \| null`
`tags`	`object \| any`
`notes`	`object \| any`
`companies`	`object \| any`

Contacts Search

Search and filter contacts records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await intercom.contacts.search(
    query={"filter": {"eq": {"android_app_name": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "contacts",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"android_app_name": "<str>"}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's `meta.cursor`
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`android_app_name`	`string`	The name of the Android app associated with the contact.
`android_app_version`	`string`	The version of the Android app associated with the contact.
`android_device`	`string`	The device used by the contact for Android.
`android_last_seen_at`	`string`	The date and time when the contact was last seen on Android.
`android_os_version`	`string`	The operating system version of the Android device.
`android_sdk_version`	`string`	The SDK version of the Android device.
`avatar`	`string`	URL pointing to the contact's avatar image.
`browser`	`string`	The browser used by the contact.
`browser_language`	`string`	The language preference set in the contact's browser.
`browser_version`	`string`	The version of the browser used by the contact.
`companies`	`object`	Companies associated with the contact.
`created_at`	`integer`	The date and time when the contact was created.
`custom_attributes`	`object`	Custom attributes defined for the contact.
`email`	`string`	The email address of the contact.
`external_id`	`string`	External identifier for the contact.
`has_hard_bounced`	`boolean`	Flag indicating if the contact has hard bounced.
`id`	`string`	The unique identifier of the contact.
`ios_app_name`	`string`	The name of the iOS app associated with the contact.
`ios_app_version`	`string`	The version of the iOS app associated with the contact.
`ios_device`	`string`	The device used by the contact for iOS.
`ios_last_seen_at`	`integer`	The date and time when the contact was last seen on iOS.
`ios_os_version`	`string`	The operating system version of the iOS device.
`ios_sdk_version`	`string`	The SDK version of the iOS device.
`language_override`	`string`	Language override set for the contact.
`last_contacted_at`	`integer`	The date and time when the contact was last contacted.
`last_email_clicked_at`	`integer`	The date and time when the contact last clicked an email.
`last_email_opened_at`	`integer`	The date and time when the contact last opened an email.
`last_replied_at`	`integer`	The date and time when the contact last replied.
`last_seen_at`	`integer`	The date and time when the contact was last seen overall.
`location`	`object`	Location details of the contact.
`marked_email_as_spam`	`boolean`	Flag indicating if the contact's email was marked as spam.
`name`	`string`	The name of the contact.
`notes`	`object`	Notes associated with the contact.
`opted_in_subscription_types`	`object`	Subscription types the contact opted into.
`opted_out_subscription_types`	`object`	Subscription types the contact opted out from.
`os`	`string`	Operating system of the contact's device.
`owner_id`	`integer`	The unique identifier of the contact's owner.
`phone`	`string`	The phone number of the contact.
`referrer`	`string`	Referrer information related to the contact.
`role`	`string`	Role or position of the contact.
`signed_up_at`	`integer`	The date and time when the contact signed up.
`sms_consent`	`boolean`	Consent status for SMS communication.
`social_profiles`	`object`	Social profiles associated with the contact.
`tags`	`object`	Tags associated with the contact.
`type`	`string`	Type of contact.
`unsubscribed_from_emails`	`boolean`	Flag indicating if the contact unsubscribed from emails.
`unsubscribed_from_sms`	`boolean`	Flag indicating if the contact unsubscribed from SMS.
`updated_at`	`integer`	The date and time when the contact was last updated.
`utm_campaign`	`string`	Campaign data from UTM parameters.
`utm_content`	`string`	Content data from UTM parameters.
`utm_medium`	`string`	Medium data from UTM parameters.
`utm_source`	`string`	Source data from UTM parameters.
`utm_term`	`string`	Term data from UTM parameters.
`workspace_id`	`string`	The unique identifier of the workspace associated with the contact.

Field Name	Type	Description
`data`	`array`	List of matching records
`meta`	`object`	Pagination metadata
`meta.has_more`	`boolean`	Whether additional pages are available
`meta.cursor`	`string \| null`	Cursor for next page of results
`meta.took_ms`	`number \| null`	Query execution time in milliseconds
`data[].android_app_name`	`string`	The name of the Android app associated with the contact.
`data[].android_app_version`	`string`	The version of the Android app associated with the contact.
`data[].android_device`	`string`	The device used by the contact for Android.
`data[].android_last_seen_at`	`string`	The date and time when the contact was last seen on Android.
`data[].android_os_version`	`string`	The operating system version of the Android device.
`data[].android_sdk_version`	`string`	The SDK version of the Android device.
`data[].avatar`	`string`	URL pointing to the contact's avatar image.
`data[].browser`	`string`	The browser used by the contact.
`data[].browser_language`	`string`	The language preference set in the contact's browser.
`data[].browser_version`	`string`	The version of the browser used by the contact.
`data[].companies`	`object`	Companies associated with the contact.
`data[].created_at`	`integer`	The date and time when the contact was created.
`data[].custom_attributes`	`object`	Custom attributes defined for the contact.
`data[].email`	`string`	The email address of the contact.
`data[].external_id`	`string`	External identifier for the contact.
`data[].has_hard_bounced`	`boolean`	Flag indicating if the contact has hard bounced.
`data[].id`	`string`	The unique identifier of the contact.
`data[].ios_app_name`	`string`	The name of the iOS app associated with the contact.
`data[].ios_app_version`	`string`	The version of the iOS app associated with the contact.
`data[].ios_device`	`string`	The device used by the contact for iOS.
`data[].ios_last_seen_at`	`integer`	The date and time when the contact was last seen on iOS.
`data[].ios_os_version`	`string`	The operating system version of the iOS device.
`data[].ios_sdk_version`	`string`	The SDK version of the iOS device.
`data[].language_override`	`string`	Language override set for the contact.
`data[].last_contacted_at`	`integer`	The date and time when the contact was last contacted.
`data[].last_email_clicked_at`	`integer`	The date and time when the contact last clicked an email.
`data[].last_email_opened_at`	`integer`	The date and time when the contact last opened an email.
`data[].last_replied_at`	`integer`	The date and time when the contact last replied.
`data[].last_seen_at`	`integer`	The date and time when the contact was last seen overall.
`data[].location`	`object`	Location details of the contact.
`data[].marked_email_as_spam`	`boolean`	Flag indicating if the contact's email was marked as spam.
`data[].name`	`string`	The name of the contact.
`data[].notes`	`object`	Notes associated with the contact.
`data[].opted_in_subscription_types`	`object`	Subscription types the contact opted into.
`data[].opted_out_subscription_types`	`object`	Subscription types the contact opted out from.
`data[].os`	`string`	Operating system of the contact's device.
`data[].owner_id`	`integer`	The unique identifier of the contact's owner.
`data[].phone`	`string`	The phone number of the contact.
`data[].referrer`	`string`	Referrer information related to the contact.
`data[].role`	`string`	Role or position of the contact.
`data[].signed_up_at`	`integer`	The date and time when the contact signed up.
`data[].sms_consent`	`boolean`	Consent status for SMS communication.
`data[].social_profiles`	`object`	Social profiles associated with the contact.
`data[].tags`	`object`	Tags associated with the contact.
`data[].type`	`string`	Type of contact.
`data[].unsubscribed_from_emails`	`boolean`	Flag indicating if the contact unsubscribed from emails.
`data[].unsubscribed_from_sms`	`boolean`	Flag indicating if the contact unsubscribed from SMS.
`data[].updated_at`	`integer`	The date and time when the contact was last updated.
`data[].utm_campaign`	`string`	Campaign data from UTM parameters.
`data[].utm_content`	`string`	Content data from UTM parameters.
`data[].utm_medium`	`string`	Medium data from UTM parameters.
`data[].utm_source`	`string`	Source data from UTM parameters.
`data[].utm_term`	`string`	Term data from UTM parameters.
`data[].workspace_id`	`string`	The unique identifier of the workspace associated with the contact.

Conversations

Conversations List

Returns a paginated list of conversations

Python SDK

await intercom.conversations.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "conversations",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`per_page`	`integer`	No	Number of conversations to return per page
`starting_after`	`string`	No	Cursor for pagination

Records

Field Name	Type	Description
`type`	`string \| null`
`id`	`string`
`title`	`string \| null`
`created_at`	`integer \| null`
`updated_at`	`integer \| null`
`waiting_since`	`integer \| null`
`snoozed_until`	`integer \| null`
`open`	`boolean \| null`
`state`	`string \| null`
`read`	`boolean \| null`
`priority`	`string \| null`
`admin_assignee_id`	`integer \| null`
`team_assignee_id`	`string \| null`
`tags`	`object \| any`
`conversation_rating`	`object \| any`
`source`	`object \| any`
`contacts`	`object \| any`
`teammates`	`object \| any`
`first_contact_reply`	`object \| any`
`sla_applied`	`object \| any`
`statistics`	`object \| any`
`conversation_parts`	`object \| any`
`custom_attributes`	`object \| null`

Field Name	Type	Description
`next_page`	`string \| null`

Conversations Get

Get a single conversation by ID

Python SDK

await intercom.conversations.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "conversations",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`id`	`string`	Yes	Conversation ID

Records

Field Name	Type	Description
`type`	`string \| null`
`id`	`string`
`title`	`string \| null`
`created_at`	`integer \| null`
`updated_at`	`integer \| null`
`waiting_since`	`integer \| null`
`snoozed_until`	`integer \| null`
`open`	`boolean \| null`
`state`	`string \| null`
`read`	`boolean \| null`
`priority`	`string \| null`
`admin_assignee_id`	`integer \| null`
`team_assignee_id`	`string \| null`
`tags`	`object \| any`
`conversation_rating`	`object \| any`
`source`	`object \| any`
`contacts`	`object \| any`
`teammates`	`object \| any`
`first_contact_reply`	`object \| any`
`sla_applied`	`object \| any`
`statistics`	`object \| any`
`conversation_parts`	`object \| any`
`custom_attributes`	`object \| null`

Conversations Search

Search and filter conversations records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await intercom.conversations.search(
    query={"filter": {"eq": {"admin_assignee_id": 0}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "conversations",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"admin_assignee_id": 0}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's `meta.cursor`
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`admin_assignee_id`	`integer`	The ID of the administrator assigned to the conversation
`ai_agent`	`object`	Data related to AI Agent involvement in the conversation
`ai_agent_participated`	`boolean`	Indicates whether AI Agent participated in the conversation
`assignee`	`object`	The assigned user responsible for the conversation.
`contacts`	`object`	List of contacts involved in the conversation.
`conversation_message`	`object`	The main message content of the conversation.
`conversation_rating`	`object`	Ratings given to the conversation by the customer and teammate.
`created_at`	`integer`	The timestamp when the conversation was created
`custom_attributes`	`object`	Custom attributes associated with the conversation
`customer_first_reply`	`object`	Timestamp indicating when the customer first replied.
`customers`	`array`	List of customers involved in the conversation
`first_contact_reply`	`object`	Timestamp indicating when the first contact replied.
`id`	`string`	The unique ID of the conversation
`linked_objects`	`object`	Linked objects associated with the conversation
`open`	`boolean`	Indicates if the conversation is open or closed
`priority`	`string`	The priority level of the conversation
`read`	`boolean`	Indicates if the conversation has been read
`redacted`	`boolean`	Indicates if the conversation is redacted
`sent_at`	`integer`	The timestamp when the conversation was sent
`sla_applied`	`object`	Service Level Agreement details applied to the conversation.
`snoozed_until`	`integer`	Timestamp until the conversation is snoozed
`source`	`object`	Source details of the conversation.
`state`	`string`	The state of the conversation (e.g., new, in progress)
`statistics`	`object`	Statistics related to the conversation.
`tags`	`object`	Tags applied to the conversation.
`team_assignee_id`	`integer`	The ID of the team assigned to the conversation
`teammates`	`object`	List of teammates involved in the conversation.
`title`	`string`	The title of the conversation
`topics`	`object`	Topics associated with the conversation.
`type`	`string`	The type of the conversation
`updated_at`	`integer`	The timestamp when the conversation was last updated
`user`	`object`	The user related to the conversation.
`waiting_since`	`integer`	Timestamp since waiting for a response

Field Name	Type	Description
`data`	`array`	List of matching records
`meta`	`object`	Pagination metadata
`meta.has_more`	`boolean`	Whether additional pages are available
`meta.cursor`	`string \| null`	Cursor for next page of results
`meta.took_ms`	`number \| null`	Query execution time in milliseconds
`data[].admin_assignee_id`	`integer`	The ID of the administrator assigned to the conversation
`data[].ai_agent`	`object`	Data related to AI Agent involvement in the conversation
`data[].ai_agent_participated`	`boolean`	Indicates whether AI Agent participated in the conversation
`data[].assignee`	`object`	The assigned user responsible for the conversation.
`data[].contacts`	`object`	List of contacts involved in the conversation.
`data[].conversation_message`	`object`	The main message content of the conversation.
`data[].conversation_rating`	`object`	Ratings given to the conversation by the customer and teammate.
`data[].created_at`	`integer`	The timestamp when the conversation was created
`data[].custom_attributes`	`object`	Custom attributes associated with the conversation
`data[].customer_first_reply`	`object`	Timestamp indicating when the customer first replied.
`data[].customers`	`array`	List of customers involved in the conversation
`data[].first_contact_reply`	`object`	Timestamp indicating when the first contact replied.
`data[].id`	`string`	The unique ID of the conversation
`data[].linked_objects`	`object`	Linked objects associated with the conversation
`data[].open`	`boolean`	Indicates if the conversation is open or closed
`data[].priority`	`string`	The priority level of the conversation
`data[].read`	`boolean`	Indicates if the conversation has been read
`data[].redacted`	`boolean`	Indicates if the conversation is redacted
`data[].sent_at`	`integer`	The timestamp when the conversation was sent
`data[].sla_applied`	`object`	Service Level Agreement details applied to the conversation.
`data[].snoozed_until`	`integer`	Timestamp until the conversation is snoozed
`data[].source`	`object`	Source details of the conversation.
`data[].state`	`string`	The state of the conversation (e.g., new, in progress)
`data[].statistics`	`object`	Statistics related to the conversation.
`data[].tags`	`object`	Tags applied to the conversation.
`data[].team_assignee_id`	`integer`	The ID of the team assigned to the conversation
`data[].teammates`	`object`	List of teammates involved in the conversation.
`data[].title`	`string`	The title of the conversation
`data[].topics`	`object`	Topics associated with the conversation.
`data[].type`	`string`	The type of the conversation
`data[].updated_at`	`integer`	The timestamp when the conversation was last updated
`data[].user`	`object`	The user related to the conversation.
`data[].waiting_since`	`integer`	Timestamp since waiting for a response

Companies

Companies List

Returns a paginated list of companies

Python SDK

await intercom.companies.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "companies",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`per_page`	`integer`	No	Number of companies to return per page
`starting_after`	`string`	No	Cursor for pagination

Records

Field Name	Type	Description
`type`	`string \| null`
`id`	`string`
`app_id`	`string \| null`
`name`	`string \| null`
`company_id`	`string \| null`
`plan`	`object \| any`
`size`	`integer \| null`
`industry`	`string \| null`
`website`	`string \| null`
`remote_created_at`	`integer \| null`
`created_at`	`integer \| null`
`updated_at`	`integer \| null`
`last_request_at`	`integer \| null`
`session_count`	`integer \| null`
`monthly_spend`	`number \| null`
`user_count`	`integer \| null`
`tags`	`object \| any`
`segments`	`object \| any`
`custom_attributes`	`object \| null`

Field Name	Type	Description
`next_page`	`string \| null`

Companies Create

Create a new company or update an existing one by company_id

Python SDK

await intercom.companies.create(
    company_id="<str>",
    name="<str>",
    plan="<str>",
    monthly_spend=0.0,
    size=0,
    website="<str>",
    industry="<str>",
    custom_attributes={}
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "companies",
    "action": "create",
    "params": {
        "company_id": "<str>",
        "name": "<str>",
        "plan": "<str>",
        "monthly_spend": 0.0,
        "size": 0,
        "website": "<str>",
        "industry": "<str>",
        "custom_attributes": {}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`company_id`	`string`	Yes	A unique identifier for the company from your system
`name`	`string`	No	The name of the company
`plan`	`string`	No	The name of the plan the company is on
`monthly_spend`	`number`	No	The monthly spend of the company
`size`	`integer`	No	The number of employees in the company
`website`	`string`	No	The URL of the company website
`industry`	`string`	No	The industry the company operates in
`custom_attributes`	`object`	No	Custom attributes for the company

Records

Field Name	Type	Description
`type`	`string \| null`
`id`	`string`
`app_id`	`string \| null`
`name`	`string \| null`
`company_id`	`string \| null`
`plan`	`object \| any`
`size`	`integer \| null`
`industry`	`string \| null`
`website`	`string \| null`
`remote_created_at`	`integer \| null`
`created_at`	`integer \| null`
`updated_at`	`integer \| null`
`last_request_at`	`integer \| null`
`session_count`	`integer \| null`
`monthly_spend`	`number \| null`
`user_count`	`integer \| null`
`tags`	`object \| any`
`segments`	`object \| any`
`custom_attributes`	`object \| null`

Companies Get

Get a single company by ID

Python SDK

await intercom.companies.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: B

…(truncated)

Intercom full reference

File contents

Intercom full reference

Supported entities and actions

Contacts

Contacts List

Python SDK

API

Parameters

Records

Meta

Contacts Create

Python SDK

API

Parameters

Records

Contacts Get

Python SDK

API

Parameters

Records

Contacts Update

Python SDK

API

Parameters

Records

Contacts Search

Python SDK

API

Parameters

Searchable Fields

Conversations

Conversations List

Python SDK

API

Parameters

Records

Meta

Conversations Get

Python SDK

API

Parameters

Records

Conversations Search

Python SDK

API

Parameters

Searchable Fields

Companies

Companies List

Python SDK

API

Parameters

Records

Meta

Companies Create

Python SDK

API

Parameters

Records

Companies Get

Python SDK

API

Related skills

Frequently asked questions

How do I install the Intercom full reference skill?

What does the Intercom full reference skill do?

Is Intercom full reference safe to use?

Which AI agents work with Intercom full reference?

Is Intercom full reference free to use?

Who published Intercom full reference?