--- title: "Connect Intercom to Mintlify - APIANT.ai" description: "When \"New conversation\" fires in Intercom, your agent runs \"Send agent job follow-up message\" in Mintlify." canonical: "https://apiant.ai/connect/intercom-to-mintlify" --- # Connect Intercom to Mintlify When **New conversation** fires in [Intercom](https://apiant.ai/connections/intercom), your agent runs **Send agent job follow-up message** in [Mintlify](https://apiant.ai/connections/mintlify). Describe the whole flow and it is built, tested on every scenario and kept running. Intercom **4** triggers Intercom **24** actions Mintlify **7** actions What the catalog holds today. Ask for anything missing and your agent reads the API documentation and adds it. ## What do you want Intercom and Mintlify to do together? Give your AI client this address. `https://mcp.apiant.ai` One connection does both: ask your client to act in an app once, or have it build an automation that keeps running. Any client that takes a remote MCP server. Nothing to install. Create your free account, then sign in once in your browser. ### Set it up in your client ### Claude Code Run this in the directory you want to work in. `claude mcp add --transport http -s project apiant-ai https://mcp.apiant.ai` Start Claude Code there, approve the server, and sign in in the browser page it opens. [Claude Code guide (opens in a new tab)](https://apiant.ai/docs/mcp/claude-code) ### Claude, web and desktop Open Customize, then Connectors, then Add custom connector, and paste the address. On Team and Enterprise an owner adds it first. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) ### Cursor Add the address to your MCP configuration as a server URL. Cursor signs you in in your browser. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) ### Zed Open Settings, then AI, then MCP Servers, then Add Server, then Add Remote Server. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) ### Codex and the ChatGPT desktop app Open Settings, then MCP servers, then Add server, and choose Streamable HTTP. From the terminal, Codex takes the address with its own add command and then signs you in. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) ### Any other MCP client Paste the address where the client asks for a remote MCP server URL, and name the server apiant-ai where it lets you. APIANT's skills reach the client over the same connection. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) Intercom is where customers tell you what the docs are missing; Mintlify is where the docs get written. Connecting them lets a support ticket or conversation in Intercom start a Mintlify agent job, follow that job to its pull request, and send the link back onto the Intercom ticket. You can also pull Mintlify page view counts when a contact leaves feedback. Example flows ## What Intercom can start in Mintlify - When **New conversation** in Intercom then **Send agent job follow-up message** in Mintlify - When **New or updated contact** in Intercom then **List page views** in Mintlify Starting points drawn from the triggers and actions in the catalog today. Describe the flow you need, at any depth, and your agent builds it and tests every scenario before it ships. Everything your agent can do with Intercom and Mintlify ## Triggers and actions 4 triggers · 31 actions - Trigger **New company** Fires when a new company is created. - Trigger **New conversation** Polls for conversations, most recently updated first. Fires for each new conversation. - Trigger **New or updated contact** Polls for contacts, most recently updated first. Fires for each new or updated contact. - Trigger **New ticket** Fires when a new ticket is created. - Action **Add note to contact** Adds a note to the specified contact as the specified admin. - Action **Add note to conversation** Adds an internal note to the specified conversation as an admin. - Action **Add tag to contact** Attaches a tag to the specified contact. - Action **Assign conversation** Assigns the conversation to an admin or team. - Action **Close conversation** Closes the specified conversation. - Action **Create message** Creates an admin-initiated email or in-app message to a contact. - Action **Delete company** Delete a company by ID. - Action **Delete contact** Deletes a contact by ID. - Action **Find admin by email** Fetches an admin's details. Lists all admins; match by email. - Action **Find contact by email** Searches contacts by email and returns matches. - Action **Find tickets** Search tickets by criteria. - Action **Get company** Retrieve a company by ID. - Action **Get contact** Fetches a contact's details by ID. - Action **Get conversation** Fetches a conversation's details by ID. - Action **Get ticket** Retrieve a ticket by ID. - Action **List companies** List all companies. - Action **List segments** List all segments. - Action **List tags** Lists all tags for the workspace. - Action **Open conversation** Opens (marks open) the specified conversation. - Action **Remove tag from contact** Detaches a tag from the specified contact. - Action **Send conversation reply** Sends a reply to the specified conversation as an admin. - Action **Snooze conversation** Snoozes the specified conversation until the given unix timestamp. - Action **Start conversation** Starts a new conversation with the specified contact. - Action **Track event** Submit a data event for a contact. - Action **Add agent job** Creates a Mintlify agent job that edits your documentation in the background from a prompt. If the agent changes files, Mintlify opens a pull request. - Action **Get agent job** Retrieves the current status and details of a Mintlify agent job, including its pull request link once created. - Action **Get update status** Get the status and details of a documentation update (deployment) from the status ID returned when the update was triggered. - Action **List page views** Returns site-wide and per-page content view counts, split by human and AI traffic, optionally limited to a date range. - Action **List unique visitors** Returns site-wide and per-page unique visitor counts, split by human and AI traffic, for an optional date range. - Action **Send agent job follow-up message** Sends a follow-up instruction to an existing Mintlify agent job. The agent processes the message asynchronously; use Get agent job to track progress. - Action **Trigger preview deployment** Create or update a preview deployment for a Git branch. If a preview already exists for the branch, it triggers a redeployment. ## Each app on its own - [ **Intercom** Intercom is a customer communications platform for support, engagement, and marketing.](https://apiant.ai/connections/intercom) - [ **Mintlify** Documentation platform for hosting API and product docs, keeping them synced with code and searchable by AI...](https://apiant.ai/connections/mintlify) Reviews ## What our customers say ## More from Intercom - [ **Intercom to HubSpot** HubSpot is your all-in-one stop for all of your marketing software needs.](https://apiant.ai/connect/intercom-to-hubspot) - [ **Intercom to Salesforce** Salesforce is a leading enterprise customer relationship management (CRM) platform.](https://apiant.ai/connect/intercom-to-salesforce) - [ **Intercom to Slack** Slack is a messaging platform for teams. Post messages, manage channels, users, reminders, and react to...](https://apiant.ai/connect/intercom-to-slack) - [ **Intercom to Stripe** Stripe is a payment processing platform for online businesses.](https://apiant.ai/connect/intercom-to-stripe) - [ **Intercom to QuickBooks Online** QuickBooks Online accounting — manage customers, invoices, bills, payments, vendors, expenses, and more via...](https://apiant.ai/connect/intercom-to-quickbooks-online) - [ **Intercom to Pipedrive** Pipedrive is a sales CRM and pipeline management tool.](https://apiant.ai/connect/intercom-to-pipedrive) ## More into Mintlify - [ **Asana to Mintlify** Asana is a collaborative information manager for workspace.](https://apiant.ai/connect/asana-to-mintlify) - [ **Freshdesk to Mintlify** Freshdesk is a cloud-based customer support and helpdesk platform.](https://apiant.ai/connect/freshdesk-to-mintlify) - [ **HubSpot to Mintlify** HubSpot is your all-in-one stop for all of your marketing software needs.](https://apiant.ai/connect/hubspot-to-mintlify) - [ **Salesforce to Mintlify** Salesforce is a leading enterprise customer relationship management (CRM) platform.](https://apiant.ai/connect/salesforce-to-mintlify) - [ **Slack to Mintlify** Slack is a messaging platform for teams. Post messages, manage channels, users, reminders, and react to...](https://apiant.ai/connect/slack-to-mintlify) - [ **Google Sheets to Mintlify** Google Sheets is Google's online spreadsheet app for creating, editing and sharing spreadsheets.](https://apiant.ai/connect/google-sheets-to-mintlify) Questions ## Intercom and Mintlify, answered ### ### Can something in Mintlify start one of these setups? No, Mintlify has no triggers here, so every setup starts in Intercom, for example a new ticket, a new conversation, a new company, or a new or updated contact. Mintlify is used for the actions that follow, such as adding an agent job or reading page views. ### ### How do I get the docs pull request link back into Intercom? After the agent job is created in Mintlify, use Get agent job to read its status and pull request link. That link can then go onto the Intercom side with Update ticket or Add note to conversation, so support sees the fix in the same place as the customer's message. ### ### What can start an automation from Intercom? Any of Intercom's 4 triggers in the catalog, including New conversation, New or updated contact, New ticket and New company. Describe the moment in plain language and your agent picks the right one. ### ### What can your agent do in Mintlify when something happens in Intercom? Any of Mintlify's 7 actions, including Add agent job, Get agent job, List page views and Send agent job follow-up message. Your agent maps the data both ways and tests every scenario before it ships. ### ### Can it also run from Mintlify to Intercom? Mintlify has no triggers in the catalog today, so automations start in Intercom. If you need the other direction, ask: your agent reads Mintlify's API documentation and adds it. ### ### Do I have to build a connector for Intercom or Mintlify? No. Both are in the catalog with their triggers and actions. You describe the automation; your agent builds it, tests every scenario and keeps it running. ### ### Can my AI client use Intercom and Mintlify without building an automation? Yes. With your AI client connected to APIANT, ask it to do something in either app once and it runs that action on the spot. Ask for an automation and your agent builds it, tests every scenario and keeps it running. One connection covers both. ### ### What happens when something fails? Your agent works that out for you. It plans the failure paths along with the happy path, then tests every scenario before it ships. ### ### Is there a free plan? Yes. Every plan includes the agent, including free, and building from your own AI client spends no assistant credits.