Sim

Intercom

Manage contacts, companies, conversations, tickets, and messages in Intercom

Intercom is a leading customer communications platform that enables you to manage and automate your interactions with contacts, companies, conversations, tickets, and messages—all in one place. The Intercom integration in Sim lets your agents programmatically manage customer relationships, support requests, and conversations directly from your automated workflows.

With the Intercom tools, you can:

  • Contacts Management: Create, get, update, list, search, and delete contacts—automate your CRM processes and keep your customer records up-to-date.
  • Company Management: Create new companies, retrieve company details, and list all companies related to your users or business clients.
  • Conversation Handling: Get, list, reply to, and search through conversations—allowing agents to track ongoing support threads, provide answers, and automate follow-up actions.
  • Ticket Management: Create and retrieve tickets programmatically, helping you automate customer service, support issue tracking, and workflow escalations.
  • Send Messages: Trigger messages to users or leads for onboarding, support, or marketing, all from within your workflow automation.

By integrating Intercom tools into Sim, you empower your workflows to communicate directly with your users, automate customer support processes, manage leads, and streamline communications at scale. Whether you need to create new contacts, keep customer data synchronized, manage support tickets, or send personalized engagement messages, the Intercom tools provide a comprehensive way to manage customer interactions as part of your intelligent automations.

Usage Instructions

Integrate Intercom into the workflow. Can create, get, update, list, search, and delete contacts; create, get, and list companies; get, list, reply, and search conversations; create and get tickets; and create messages.

Tools

intercom_create_contact

Create a new contact in Intercom with email, external_id, or role

Input

ParameterTypeRequiredDescription
rolestringNoThe role of the contact. Accepts 'user' or 'lead'. Defaults to 'lead' if not specified.
emailstringNoThe contact's email address
external_idstringNoA unique identifier for the contact provided by the client
phonestringNoThe contact's phone number
namestringNoThe contact's name
avatarstringNoAn avatar image URL for the contact
signed_up_atnumberNoThe time the user signed up as a Unix timestamp
last_seen_atnumberNoThe time the user was last seen as a Unix timestamp
owner_idstringNoThe id of an admin that has been assigned account ownership of the contact
unsubscribed_from_emailsbooleanNoWhether the contact is unsubscribed from emails
custom_attributesstringNoCustom attributes as JSON object (e.g., {"attribute_name": "value"})
company_idstringNoCompany ID to associate the contact with during creation

Output

ParameterTypeDescription
contactobjectCreated contact object

intercom_get_contact

Get a single contact by ID from Intercom

Input

ParameterTypeRequiredDescription
contactIdstringYesContact ID to retrieve

Output

ParameterTypeDescription
contactobjectContact object

intercom_update_contact

Update an existing contact in Intercom

Input

ParameterTypeRequiredDescription
contactIdstringYesContact ID to update
rolestringNoThe role of the contact. Accepts 'user' or 'lead'.
external_idstringNoA unique identifier for the contact provided by the client
emailstringNoThe contact's email address
phonestringNoThe contact's phone number
namestringNoThe contact's name
avatarstringNoAn avatar image URL for the contact
signed_up_atnumberNoThe time the user signed up as a Unix timestamp
last_seen_atnumberNoThe time the user was last seen as a Unix timestamp
owner_idstringNoThe id of an admin that has been assigned account ownership of the contact
unsubscribed_from_emailsbooleanNoWhether the contact is unsubscribed from emails
custom_attributesstringNoCustom attributes as JSON object (e.g., {"attribute_name": "value"})
company_idstringNoCompany ID to associate the contact with

Output

ParameterTypeDescription
contactobjectUpdated contact object

intercom_list_contacts

List all contacts from Intercom with pagination support

Input

ParameterTypeRequiredDescription
per_pagenumberNoNumber of results per page (max: 150)
starting_afterstringNoCursor for pagination - ID to start after

Output

ParameterTypeDescription
contactsarrayArray of contact objects

intercom_search_contacts

Search for contacts in Intercom using a query

Input

ParameterTypeRequiredDescription
querystringYesSearch query (e.g., {"field":"email","operator":"=","value":"[email protected]"})
per_pagenumberNoNumber of results per page (max: 150)
starting_afterstringNoCursor for pagination
sort_fieldstringNoField to sort by (e.g., "name", "created_at", "last_seen_at")
sort_orderstringNoSort order: "ascending" or "descending"

Output

ParameterTypeDescription
contactsarrayArray of matching contact objects

intercom_delete_contact

Delete a contact from Intercom by ID

Input

ParameterTypeRequiredDescription
contactIdstringYesContact ID to delete

Output

ParameterTypeDescription
idstringID of deleted contact
deletedbooleanWhether the contact was deleted
metadataobjectOperation metadata

intercom_create_company

Create or update a company in Intercom

Input

ParameterTypeRequiredDescription
company_idstringYesYour unique identifier for the company
namestringNoThe name of the company
websitestringNoThe company website
planstringNoThe company plan name
sizenumberNoThe number of employees in the company
industrystringNoThe industry the company operates in
monthly_spendnumberNoHow much revenue the company generates for your business. Note: This field truncates floats to whole integers (e.g., 155.98 becomes 155)
custom_attributesstringNoCustom attributes as JSON object
remote_created_atnumberNoThe time the company was created by you as a Unix timestamp

Output

ParameterTypeDescription
companyobjectCreated or updated company object

intercom_get_company

Retrieve a single company by ID from Intercom

Input

ParameterTypeRequiredDescription
companyIdstringYesCompany ID to retrieve

Output

ParameterTypeDescription
companyobjectCompany object

intercom_list_companies

List all companies from Intercom with pagination support. Note: This endpoint has a limit of 10,000 companies that can be returned using pagination. For datasets larger than 10,000 companies, use the Scroll API instead.

Input

ParameterTypeRequiredDescription
per_pagenumberNoNumber of results per page
pagenumberNoPage number
starting_afterstringNoCursor for pagination (preferred over page-based pagination)

Output

ParameterTypeDescription
companiesarrayArray of company objects

intercom_get_conversation

Retrieve a single conversation by ID from Intercom

Input

ParameterTypeRequiredDescription
conversationIdstringYesConversation ID to retrieve
display_asstringNoSet to "plaintext" to retrieve messages in plain text
include_translationsbooleanNoWhen true, conversation parts will be translated to the detected language of the conversation

Output

ParameterTypeDescription
conversationobjectConversation object

intercom_list_conversations

List all conversations from Intercom with pagination support

Input

ParameterTypeRequiredDescription
per_pagenumberNoNumber of results per page (max: 150)
starting_afterstringNoCursor for pagination
sortstringNoField to sort by (e.g., "waiting_since", "updated_at", "created_at")
orderstringNoSort order: "asc" (ascending) or "desc" (descending)

Output

ParameterTypeDescription
conversationsarrayArray of conversation objects

intercom_reply_conversation

Reply to a conversation as an admin in Intercom

Input

ParameterTypeRequiredDescription
conversationIdstringYesConversation ID to reply to
message_typestringYesMessage type: "comment" or "note"
bodystringYesThe text body of the reply
admin_idstringNoThe ID of the admin authoring the reply. If not provided, a default admin (Operator/Fin) will be used.
attachment_urlsstringNoComma-separated list of image URLs (max 10)
created_atnumberNoUnix timestamp for when the reply was created. If not provided, current time is used.

Output

ParameterTypeDescription
conversationobjectUpdated conversation object

intercom_search_conversations

Search for conversations in Intercom using a query

Input

ParameterTypeRequiredDescription
querystringYesSearch query as JSON object
per_pagenumberNoNumber of results per page (max: 150)
starting_afterstringNoCursor for pagination
sort_fieldstringNoField to sort by (e.g., "created_at", "updated_at")
sort_orderstringNoSort order: "ascending" or "descending"

Output

ParameterTypeDescription
conversationsarrayArray of matching conversation objects

intercom_create_ticket

Create a new ticket in Intercom

Input

ParameterTypeRequiredDescription
ticket_type_idstringYesThe ID of the ticket type
contactsstringYesJSON array of contact identifiers (e.g., [{"id": "contact_id"}])
ticket_attributesstringYesJSON object with ticket attributes including default_title and default_description
company_idstringNoCompany ID to associate the ticket with
created_atnumberNoUnix timestamp for when the ticket was created. If not provided, current time is used.
conversation_to_link_idstringNoID of an existing conversation to link to this ticket
disable_notificationsbooleanNoWhen true, suppresses notifications when the ticket is created

Output

ParameterTypeDescription
ticketobjectCreated ticket object

intercom_get_ticket

Retrieve a single ticket by ID from Intercom

Input

ParameterTypeRequiredDescription
ticketIdstringYesTicket ID to retrieve

Output

ParameterTypeDescription
ticketobjectTicket object

intercom_create_message

Create and send a new admin-initiated message in Intercom

Input

ParameterTypeRequiredDescription
message_typestringYesMessage type: "inapp" for in-app messages or "email" for email messages
templatestringYesMessage template style: "plain" for plain text or "personal" for personalized style
subjectstringNoThe subject of the message (for email type)
bodystringYesThe body of the message
from_typestringYesSender type: "admin"
from_idstringYesThe ID of the admin sending the message
to_typestringYesRecipient type: "contact"
to_idstringYesThe ID of the contact receiving the message
created_atnumberNoUnix timestamp for when the message was created. If not provided, current time is used.

Output

ParameterTypeDescription
messageobjectCreated message object

Notes

  • Category: tools
  • Type: intercom
incidentioJina
On this page

On this page

Usage Instructions
Tools
intercom_create_contact
Input
Output
intercom_get_contact
Input
Output
intercom_update_contact
Input
Output
intercom_list_contacts
Input
Output
intercom_search_contacts
Input
Output
intercom_delete_contact
Input
Output
intercom_create_company
Input
Output
intercom_get_company
Input
Output
intercom_list_companies
Input
Output
intercom_get_conversation
Input
Output
intercom_list_conversations
Input
Output
intercom_reply_conversation
Input
Output
intercom_search_conversations
Input
Output
intercom_create_ticket
Input
Output
intercom_get_ticket
Input
Output
intercom_create_message
Input
Output
Notes
Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started