Intercom

List contacts from Intercom with optional pagination. Returns contact details including name, email, phone, role, and custom attributes. Use per_page and starting_after for pagination through large contact lists.

Get a single contact by their Intercom ID. Returns full contact details including name, email, phone, role, location, social profiles, custom attributes, tags, companies, and activity timestamps.

Search contacts using filters. Supports filtering by fields like email, name, role, created_at, updated_at, and custom attributes. Operators include =, !=, contains, starts_with, ends_with, >, <, AND, OR. Returns matching contacts with full details.

Get the total count of contacts in the Intercom workspace. Returns the number of users and leads.

List conversations from Intercom. Can filter by admin assignment. Returns conversation previews including subject, state, priority, assignee, and timestamps. Use starting_after for pagination.

Get a single conversation with its full message history. Returns conversation details including all messages, notes, assignments, state changes, and participant information. Use display_as to control message format.

Search conversations using filters. Supports filtering by fields like created_at, updated_at, state, assignee, and custom attributes. Returns matching conversations with details.

List all admins and teammates in the Intercom workspace. Returns admin details including name, email, role, and avatar. Use this to find admin IDs for assigning conversations or replying as an admin.

Get detailed information about a specific admin or teammate. Returns name, email, role, job title, away mode status, and avatar.

List all tags in the Intercom workspace. Tags can be applied to contacts, conversations, and companies for organization and filtering. Returns tag names and IDs.

List all segments in the Intercom workspace. Segments are dynamic groups of contacts based on filter criteria. Optionally include the count of contacts in each segment.

Get detailed information about a specific segment including its name, filter criteria, and contact count.

List companies in the Intercom workspace with pagination. Returns company details including name, company_id, plan, monthly spend, user count, and custom attributes.

Get detailed information about a specific company by its Intercom ID. Returns company name, company_id, plan, monthly spend, user count, custom attributes, tags, and segments.

List custom data attributes defined in the Intercom workspace. Data attributes are custom fields that can be set on contacts, companies, or conversations. Returns attribute names, types, and descriptions.

Create a new contact in Intercom. Contacts can be either 'user' (identified customers) or 'lead' (anonymous/pre-signup visitors). Users require an email or external_id. Leads are created with whatever information is available.

Update an existing contact's details in Intercom. Can update name, email, phone, custom attributes, and other fields. Only provided fields are updated; omitted fields remain unchanged.

Reply to an existing conversation in Intercom. Can send a customer-visible reply or an internal note. Replies appear in the conversation thread and notify participants. Requires an admin_id to identify who is replying.

Add an internal note to a conversation. Notes are only visible to teammates and not to the customer. Useful for adding context, recording decisions, or leaving instructions for other team members.

Assign a conversation to a specific admin or team. Optionally include a note explaining the reason for assignment. The assignee receives a notification about the new assignment.

Snooze a conversation until a specified time. The conversation will be hidden from the inbox and automatically reopened at the snooze time. Useful for follow-ups or waiting on external actions.

Open or reopen a conversation. Changes the conversation state to 'open', making it visible in the inbox again. Use this to reopen closed or snoozed conversations that need further attention.

Close a conversation, marking it as resolved. Optionally include a closing message that will be sent to the customer. The conversation can be reopened later if needed.

Apply a tag to a contact. Tags help organize contacts into groups for filtering and segmentation. Get available tag IDs from list_tags.

Remove a tag from a contact. The tag itself is not deleted, only the association with the contact is removed.

Apply a tag to a conversation. Tags help categorize conversations for reporting and workflow automation. Get available tag IDs from list_tags.

Create a new tag in the Intercom workspace. Tags can be applied to contacts, conversations, and companies. Tag names must be unique.

Permanently delete a contact from Intercom. This removes the contact and their data permanently. For reversible removal, use archive_contact instead.

Archive a contact in Intercom. Archived contacts are removed from active lists but their data is preserved. This is reversible, unlike delete_contact.