Intercom

List all contacts (users and leads) in your Intercom workspace with pagination. Returns basic contact information including name, email, role, and timestamps. Use 'starting_after' parameter to paginate through large result sets. Contacts represent both identified users and anonymous leads.

Search for contacts using advanced filters and queries. Find contacts by email, name, role, custom attributes, tags, or any contact property. Supports complex queries with operators like equals, contains, greater than, etc. Use this when you need to find specific contacts matching criteria. Returns paginated results with full contact details.

Retrieve detailed information about a specific contact by their Intercom ID. Returns complete contact profile including email, phone, name, role (user/lead), custom attributes, tags, companies, location data, and activity timestamps. Use this when you have a contact ID and need their full details.

Create a new contact (user or lead) in Intercom. You can create a contact with email, phone, name, custom attributes, and other properties. Use 'role' to specify if this is a 'user' (identified) or 'lead' (anonymous). Set 'external_id' to link with your system's user ID. Returns the created contact with assigned Intercom ID.

Update an existing contact's information by their Intercom ID. You can modify email, phone, name, role, custom attributes, and other properties. Changes are merged with existing data. Use this to keep contact information current or add/update custom attributes. Returns the updated contact object.

Archive a contact to remove them from your active contacts list. Archived contacts don't count toward your contact limits but can be unarchived later if needed. Use this for inactive or churned customers. The contact's data is preserved. Returns the archived contact object.

List all companies in your Intercom workspace with pagination. Companies represent organizations that contain multiple contacts. Returns company information including name, company_id, plan, size, website, and custom attributes. Use this to browse through all companies or export company data.

Retrieve detailed information about a specific company by its Intercom ID. Returns complete company profile including name, company_id, plan, website, industry, employee count, monthly spend, and all custom attributes. Use this when you have a company ID and need full details.

Create a new company in Intercom. Companies represent organizations and can be associated with multiple contacts. Provide company_id (your unique identifier), name, and optionally plan, size, website, industry, and custom attributes. Returns the created company with assigned Intercom ID.

Update an existing company's information by its Intercom ID. You can modify name, plan, size, website, industry, and custom attributes. Changes are merged with existing data. Use this to keep company information current or track changes in plan/size. Returns the updated company object.