> ## Documentation Index
> Fetch the complete documentation index at: https://squad.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Intercom
> What agents can do in Intercom at each access level, and how to connect, limit, and disconnect Intercom.
Connect Intercom so your agents can work in your Intercom account. You choose an access level for each account, and Squad refuses any agent action outside that level.
## Access levels
Each Intercom account has an access level: **Read-only**, **Read + write**, and **Full access**. Squad refuses any agent action outside that level. You can also narrow or block single agents under **Per-agent access**.
| Level | The connect window describes this level as | Actions agents can use |
| ------------------------------ | ---------------------------------------------------- | ---------------------- |
| **Read-only** | "Read conversations, contacts, and admin users." | 68 of 133 |
| **Read + write** (recommended) | "Reply to conversations and create/update contacts." | 119 of 133 |
| **Full access** | "Also log events, manage articles and tickets." | 133 of 133 |
**Read + write** is the recommended level. The connect window selects it for you, and you can choose another level.
The Intercom sign-in page asks you to approve full access to your account. This is expected. Squad does not narrow the sign-in. It checks every agent action against the level you chose, and it refuses actions outside that level.
## What agents can do at each level
Each level opens with a short summary in plain tasks, then lists every action it adds, grouped by what the action works on. You do not need to name actions. Ask in plain words, and the agent searches for the matching action.
**Find an action.** Open a level and use your browser's find (Ctrl+F, or Cmd+F on a Mac) with a word from the task or part of a slug. Or ask your agent in plain words, for example "What can you do in my Intercom account?" The agent can search the Intercom actions for you.
Each action shows its name, a one-line description where the Intercom action catalog has one, and its slug. The slug is the ID that agents use when they call the action.
Agents can use 68 of the 133 Intercom actions at this level:
* View and search articles
* View and manage companies
* View and search contacts
* View segments
* View and manage admins
* View calls
* View and search conversations
* View notes
* View types
* View collections
* View and create exports
* View and manage jobs
All 68 actions at this level:
| Action | What it does | Slug |
| ----------------- | --------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| Identify an admin | You can view the currently authorised admin along with the embedded app object (a "workspace" in legacy terminology). | `INTERCOM_IDENTIFY_AN_ADMIN` |
| List all admins | You can fetch a list of admins for a given workspace. | `INTERCOM_LIST_ALL_ADMINS` |
| Retrieve an admin | You can retrieve the details of a single admin. | `INTERCOM_RETRIEVE_AN_ADMIN` |
| Action | What it does | Slug |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
| List all articles | You can fetch a list of all articles by making a GET request to [https://api.intercom.io/articles](https://api.intercom.io/articles). | `INTERCOM_LIST_ALL_ARTICLES` |
| List internal articles | Fetches one page of internal articles from Intercom. | `INTERCOM_LIST_INTERNAL_ARTICLES` |
| Retrieve an article | You can fetch the details of a single article by making a GET request to [https://api.intercom.io/articles/\<id](https://api.intercom.io/articles/\<id)>. | `INTERCOM_RETRIEVE_AN_ARTICLE` |
| Retrieve internal article | Retrieve an internal article by ID from Intercom. | `INTERCOM_RETRIEVE_INTERNAL_ARTICLE` |
| Search for articles | You can search for articles by making a GET request to [https://api.intercom.io/articles/search](https://api.intercom.io/articles/search). | `INTERCOM_SEARCH_FOR_ARTICLES` |
| Search internal articles | Searches one page of internal articles in Intercom. | `INTERCOM_SEARCH_INTERNAL_ARTICLES` |
| Action | What it does | Slug |
| -------------------- | -------------------------------------------------------------------- | ------------------------------- |
| List data attributes | List all data attributes for contacts, companies, and conversations. | `INTERCOM_LIST_DATA_ATTRIBUTES` |
| Action | What it does | Slug |
| --------------------------- | ------------------------------------------------------------------- | -------------------------------------- |
| List calls | List all phone calls from Intercom with pagination support. | `INTERCOM_LIST_CALLS` |
| List calls with transcripts | Retrieve calls by conversation IDs with transcripts when available. | `INTERCOM_LIST_CALLS_WITH_TRANSCRIPTS` |
| Show call | Retrieve a single call by ID from Intercom. | `INTERCOM_SHOW_CALL` |
| Action | What it does | Slug |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| List all collections | You can fetch a list of all collections by making a GET request to [https://api.intercom.io/help\\\_center/collections](https://api.intercom.io/help\\_center/collections). | `INTERCOM_LIST_ALL_COLLECTIONS` |
| Retrieve a collection | You can fetch the details of a single collection by making a GET request to [https://api.intercom.io/help\\\_center/collections/\<id](https://api.intercom.io/help\\_center/collections/\<id)>. | `INTERCOM_RETRIEVE_A_COLLECTION` |
| Action | What it does | Slug |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------- |
| List all companies | You can list companies. | `INTERCOM_LIST_ALL_COMPANIES` |
| List attached companies for contact | You can fetch a list of companies that are associated to a contact. | `INTERCOM_LIST_ATTACHED_COMPANIES_FOR_CONTACT` |
| Retrieve a company by ID | You can fetch a single company. | `INTERCOM_RETRIEVE_A_COMPANY_BY_ID` |
| Retrieve companies | You can fetch a single company by passing in company\_id or name. | `INTERCOM_RETRIEVE_COMPANIES` |
| Scroll over all companies | The list all companies functionality does not work well for huge datasets, and can result in errors and performance problems when paging deeply. | `INTERCOM_SCROLL_OVER_ALL_COMPANIES` |
| Action | What it does | Slug |
| --------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------- |
| Get a contact | You can fetch the details of a single contact. | `INTERCOM_GET_A_CONTACT` |
| List attached contacts | You can fetch a list of all contacts that belong to a company. | `INTERCOM_LIST_ATTACHED_CONTACTS` |
| List contacts | List all contacts (users or leads) in your Intercom workspace with pagination support. | `INTERCOM_LIST_CONTACTS` |
| Search contacts | Search for contacts using query filters with operators. | `INTERCOM_SEARCH_CONTACTS` |
| Show contact by external ID | Retrieve a contact by their external ID. | `INTERCOM_SHOW_CONTACT_BY_EXTERNAL_ID` |
| Action | What it does | Slug |
| --------------------------- | ------------------------------------------------------ | -------------------------------------- |
| Get content import source | Retrieve a content import source by its ID. | `INTERCOM_GET_CONTENT_IMPORT_SOURCE` |
| List content import sources | Retrieve all content import sources for the workspace. | `INTERCOM_LIST_CONTENT_IMPORT_SOURCES` |
| Action | What it does | Slug |
| -------------------- | ------------------------------------------------------------------------------------- | ------------------------------- |
| Get conversation | Retrieves a specific conversation by ID with all messages and details. | `INTERCOM_GET_CONVERSATION` |
| List conversations | Lists all conversations from Intercom with pagination support. | `INTERCOM_LIST_CONVERSATIONS` |
| Search conversations | Searches for conversations using query string with support for filtering and sorting. | `INTERCOM_SEARCH_CONVERSATIONS` |
| Action | What it does | Slug |
| ---------------- | ------------------------------------------------------ | --------------------------- |
| List data events | Retrieve a log of data events belonging to a customer. | `INTERCOM_LIST_DATA_EVENTS` |
| Action | What it does | Slug |
| -------------------- | ------------------------------------------------------ | ------------------------------- |
| Create data export | Initiate an async data export job for message content. | `INTERCOM_CREATE_DATA_EXPORT` |
| Download data export | Download content data export from Intercom. | `INTERCOM_DOWNLOAD_DATA_EXPORT` |
| Action | What it does | Slug |
| --------------- | --------------------------------------------- | -------------------------- |
| List news items | Fetch a list of all news items from Intercom. | `INTERCOM_LIST_NEWS_ITEMS` |
| Action | What it does | Slug |
| --------------------- | ----------------------------------------- | -------------------------------- |
| Jobs status | Retrieve the status of job execution. | `INTERCOM_JOBS_STATUS` |
| Retrieve a job status | Retrieve the status of a data export job. | `INTERCOM_RETRIEVE_A_JOB_STATUS` |
| Action | What it does | Slug |
| ---------------------- | -------------------------------------------------------- | --------------------------------- |
| List all activity logs | You can get a log of activities by all admins in an app. | `INTERCOM_LIST_ALL_ACTIVITY_LOGS` |
| Action | What it does | Slug |
| ---------------- | --------------------------------------------------------------------------------------------- | --------------------------- |
| List all macros | Fetch a list of all macros (saved replies) in your workspace for use in automating responses. | `INTERCOM_LIST_ALL_MACROS` |
| Retrieve a macro | Fetch a single macro (saved reply) by its ID. | `INTERCOM_RETRIEVE_A_MACRO` |
| Action | What it does | Slug |
| ------------------ | --------------------------------------------------------------- | ----------------------------- |
| List all notes | You can fetch a list of notes that are associated to a contact. | `INTERCOM_LIST_ALL_NOTES` |
| List company notes | List all notes associated with a specific company. | `INTERCOM_LIST_COMPANY_NOTES` |
| Retrieve note | Retrieve details of a single note by its identifier. | `INTERCOM_RETRIEVE_NOTE` |
| Action | What it does | Slug |
| ----------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------- |
| Get custom object instance by external ID | Retrieve a custom object instance by its external\_id. | `INTERCOM_GET_CUSTOM_OBJECT_INSTANCE_BY_EXTERNAL_ID` |
| Action | What it does | Slug |
| ------------------- | --------------------------------------------------------- | ------------------------------ |
| Get external page | Retrieve an external page from Fin Content Library by ID. | `INTERCOM_GET_EXTERNAL_PAGE` |
| List external pages | List all external pages from Fin Content Library. | `INTERCOM_LIST_EXTERNAL_PAGES` |
| Action | What it does | Slug |
| ------------------------- | ---------------------------------------------------------------------------- | ------------------------------------ |
| List help center sections | Fetch a list of all help center sections in descending order by updated\_at. | `INTERCOM_LIST_HELP_CENTER_SECTIONS` |
| Action | What it does | Slug |
| ------------------------------------ | ----------------------------------------------------------------------------------------- | ----------------------------------------------- |
| List attached segments for companies | You can fetch a list of all segments that belong to a company. | `INTERCOM_LIST_ATTACHED_SEGMENTS_FOR_COMPANIES` |
| List attached segments for contact | You can fetch a list of segments that are associated to a contact. | `INTERCOM_LIST_ATTACHED_SEGMENTS_FOR_CONTACT` |
| List segments | Retrieve all segments defined within a workspace for filtering and categorizing contacts. | `INTERCOM_LIST_SEGMENTS` |
| Retrieve a segment | Retrieve details for a single segment by its ID. | `INTERCOM_RETRIEVE_A_SEGMENT` |
| Action | What it does | Slug |
| -------------------------------- | -------------------------------------------------------------------------- | ------------------------------------------- |
| List subscriptions for a contact | You can fetch a list of subscription types that are attached to a contact. | `INTERCOM_LIST_SUBSCRIPTIONS_FOR_A_CONTACT` |
| Action | What it does | Slug |
| ------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------ |
| Find tag | Retrieve details for a specific tag by its ID. | `INTERCOM_FIND_TAG` |
| List tags | Fetch all tags for the workspace. | `INTERCOM_LIST_TAGS` |
| List tags attached to a contact | You can fetch a list of all tags that are attached to a specific contact. | `INTERCOM_LIST_TAGS_ATTACHED_TO_A_CONTACT` |
| Action | What it does | Slug |
| ------------- | ---------------------------------------------------------- | ------------------------ |
| List teams | Retrieve all teams within a workspace. | `INTERCOM_LIST_TEAMS` |
| Retrieve team | Retrieve detailed information about a specific team by ID. | `INTERCOM_RETRIEVE_TEAM` |
| Action | What it does | Slug |
| ------------------ | --------------------------------------------------------- | ----------------------------- |
| Get ticket | Retrieve a ticket from Intercom. | `INTERCOM_GET_TICKET` |
| List ticket states | Fetch all ticket states for the workspace. | `INTERCOM_LIST_TICKET_STATES` |
| Search tickets | Search tickets in Intercom by filtering attribute values. | `INTERCOM_SEARCH_TICKETS` |
| Action | What it does | Slug |
| -------------------- | ------------------------------- | ------------------------------- |
| Show call transcript | Get call transcript by call ID. | `INTERCOM_SHOW_CALL_TRANSCRIPT` |
| Action | What it does | Slug |
| ----------------------- | ------------------------------------------------------- | ---------------------------------- |
| Get ticket type | Retrieve details for a specific ticket type by its ID. | `INTERCOM_GET_TICKET_TYPE` |
| List subscription types | List all subscription types available in the workspace. | `INTERCOM_LIST_SUBSCRIPTION_TYPES` |
| List ticket types | Retrieve all ticket types for the workspace. | `INTERCOM_LIST_TICKET_TYPES` |
| Action | What it does | Slug |
| ----------------------------- | ----------------------------------------------------------- | ---------------------------------------- |
| Retrieve visitor with user ID | Retrieve a specific visitor's details using their user\_id. | `INTERCOM_RETRIEVE_VISITOR_WITH_USER_ID` |
| Action | What it does | Slug |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| Get counts | Retrieve summary counts for Intercom app entities including companies, users, leads, tags, segments, and conversations. | `INTERCOM_GET_COUNTS` |
| List all help centers | You can list all Help Centers by making a GET request to [https://api.intercom.io/help\\\_center/help\\\_centers](https://api.intercom.io/help\\_center/help\\_centers). | `INTERCOM_LIST_ALL_HELP_CENTERS` |
| List away status reasons | Retrieve all away status reasons for a workspace including deleted ones. | `INTERCOM_LIST_AWAY_STATUS_REASONS` |
| Retrieve a help center | You can fetch the details of a single Help Center by making a GET request to [https://api.intercom.io/help\\\_center/help\\\_center/\<id](https://api.intercom.io/help\\_center/help\\_center/\<id)>. | `INTERCOM_RETRIEVE_A_HELP_CENTER` |
Agents can use 119 of the 133 Intercom actions at this level: everything in **Read-only**, plus:
* Create, update, and archive contacts
* Create and update tags
* Create and update articles
* Create and update attributes
* Create and update conversations
* Create, update, and send tickets
* Update admins
* Create and update collections
* Create and manage events
* Create and update pages
* Create and update types
* Create calls
The 51 actions that this level adds to **Read-only**:
| Action | What it does | Slug |
| -------------------- | ------------------------------------------- | ------------------------------- |
| Set admin to away | Set an admin to away status in Intercom. | `INTERCOM_SET_ADMIN_TO_AWAY` |
| Set an admin to away | You can set an Admin as away for the Inbox. | `INTERCOM_SET_AN_ADMIN_TO_AWAY` |
| Action | What it does | Slug |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| Create an article | You can create a new article by making a POST request to [https://api.intercom.io/articles](https://api.intercom.io/articles). | `INTERCOM_CREATE_AN_ARTICLE` |
| Create internal article | Create a new internal article for team knowledge sharing. | `INTERCOM_CREATE_INTERNAL_ARTICLE` |
| Update an article | You can update the details of a single article by making a PUT request to [https://api.intercom.io/articles/\<id](https://api.intercom.io/articles/\<id)>. | `INTERCOM_UPDATE_AN_ARTICLE` |
| Update internal article | Update an internal article with new title, body, author or owner information. | `INTERCOM_UPDATE_INTERNAL_ARTICLE` |
| Action | What it does | Slug |
| ---------------------------- | --------------------------------------------------------- | --------------------------------------- |
| Create data attribute | Create a custom data attribute for contacts or companies. | `INTERCOM_CREATE_DATA_ATTRIBUTE` |
| Create ticket type attribute | Create a new attribute for a ticket type in Intercom. | `INTERCOM_CREATE_TICKET_TYPE_ATTRIBUTE` |
| Update data attribute | Update an existing data attribute in Intercom. | `INTERCOM_UPDATE_DATA_ATTRIBUTE` |
| Update ticket type attribute | Update an existing attribute for a ticket type. | `INTERCOM_UPDATE_TICKET_TYPE_ATTRIBUTE` |
| Action | What it does | Slug |
| ----------------------- | ---------------------------------------- | ---------------------------------- |
| Register fin voice call | Register a Fin Voice call with Intercom. | `INTERCOM_REGISTER_FIN_VOICE_CALL` |
| Action | What it does | Slug |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| Create a collection | You can create a new collection by making a POST request to [https://api.intercom.io/help\\\_center/collections](https://api.intercom.io/help\\_center/collections). | `INTERCOM_CREATE_A_COLLECTION` |
| Update a collection | You can update the details of a single collection by making a PUT request to [https://api.intercom.io/collections/\<id](https://api.intercom.io/collections/\<id)>. | `INTERCOM_UPDATE_A_COLLECTION` |
| Action | What it does | Slug |
| -------------------------- | ------------------------------------------------------------------ | ------------------------------------- |
| Create or update a company | You can create or update a company. | `INTERCOM_CREATE_OR_UPDATE_A_COMPANY` |
| Update a company | You can update a single company using the Intercom provisioned id. | `INTERCOM_UPDATE_A_COMPANY` |
| Action | What it does | Slug |
| ------------------------------ | ----------------------------------------------------------------------------- | ----------------------------------------- |
| Attach contact to company | Attach a contact to a company in Intercom. | `INTERCOM_ATTACH_CONTACT_TO_COMPANY` |
| Attach contact to conversation | Attach a contact participant to a conversation on behalf of admin or contact. | `INTERCOM_ATTACH_CONTACT_TO_CONVERSATION` |
| Block contact | Block a single contact in Intercom. | `INTERCOM_BLOCK_CONTACT` |
| Create contact | Create a new contact in Intercom workspace. | `INTERCOM_CREATE_CONTACT` |
| Detach a contact | Remove a tag from a specific contact in Intercom. | `INTERCOM_DETACH_A_CONTACT` |
| Detach contact from company | Detach a contact from a company in Intercom. | `INTERCOM_DETACH_CONTACT_FROM_COMPANY` |
| Unarchive contact | Unarchive a previously archived contact in Intercom. | `INTERCOM_UNARCHIVE_CONTACT` |
| Update a contact | You can update an existing contact (ie. user or lead). | `INTERCOM_UPDATE_A_CONTACT` |
| Update contact | Update an existing contact in Intercom. | `INTERCOM_UPDATE_CONTACT` |
| Action | What it does | Slug |
| ---------------------------- | ---------------------------------------------------------------- | --------------------------------------- |
| Create content import source | Create a new content import source for the Fin Content Library. | `INTERCOM_CREATE_CONTENT_IMPORT_SOURCE` |
| Update content import source | Update an existing content import source in Fin Content Library. | `INTERCOM_UPDATE_CONTENT_IMPORT_SOURCE` |
| Action | What it does | Slug |
| --------------------- | --------------------------------------------------------------- | -------------------------------- |
| Assign conversation | Assigns a conversation to a specific admin or team in Intercom. | `INTERCOM_ASSIGN_CONVERSATION` |
| Close conversation | Closes a conversation in Intercom, marking it as resolved. | `INTERCOM_CLOSE_CONVERSATION` |
| Create conversation | Creates a new conversation in Intercom. | `INTERCOM_CREATE_CONVERSATION` |
| Reopen conversation | Reopens a closed conversation in Intercom. | `INTERCOM_REOPEN_CONVERSATION` |
| Reply to conversation | Sends a reply to an existing conversation in Intercom. | `INTERCOM_REPLY_TO_CONVERSATION` |
| Action | What it does | Slug |
| -------------------- | ------------------------------------------------------------- | ------------------------------- |
| Create data event | Submit a data event to Intercom to track user activities. | `INTERCOM_CREATE_DATA_EVENT` |
| Data event summaries | Create event summaries for a user to track event occurrences. | `INTERCOM_DATA_EVENT_SUMMARIES` |
| Action | What it does | Slug |
| ------------------ | ----------------------------------------- | ----------------------------- |
| Cancel data export | Cancel an active content data export job. | `INTERCOM_CANCEL_DATA_EXPORT` |
| Action | What it does | Slug |
| ------------- | --------------------------------------- | ------------------------ |
| Create a note | You can add a note to a single contact. | `INTERCOM_CREATE_A_NOTE` |
| Action | What it does | Slug |
| -------------------- | ----------------------------------------------------------------------------------------- | ------------------------------- |
| Create external page | Create an external page in Fin Content Library or update an existing page by external ID. | `INTERCOM_CREATE_EXTERNAL_PAGE` |
| Update external page | Update an existing external page in Fin Content Library. | `INTERCOM_UPDATE_EXTERNAL_PAGE` |
| Action | What it does | Slug |
| -------------------------- | ----------------------------------------------------- | ------------------------------------- |
| Create help center section | Create a new help center section within a collection. | `INTERCOM_CREATE_HELP_CENTER_SECTION` |
| Action | What it does | Slug |
| ----------------------------- | ------------------------------------------------- | ---------------------------------------- |
| Add subscription to a contact | You can add a specific subscription to a contact. | `INTERCOM_ADD_SUBSCRIPTION_TO_A_CONTACT` |
| Action | What it does | Slug |
| ---------------------------- | --------------------------------------------------------------------------- | --------------------------------------- |
| Add tag to contact | Add a tag to a contact in Intercom. | `INTERCOM_ADD_TAG_TO_CONTACT` |
| Attach tag to conversation | Add a tag to a specific conversation in Intercom. | `INTERCOM_ATTACH_TAG_TO_CONVERSATION` |
| Attach tag to ticket | Add a tag to a ticket in Intercom. | `INTERCOM_ATTACH_TAG_TO_TICKET` |
| Create tag | Create or update a tag, and optionally tag/untag companies or tag contacts. | `INTERCOM_CREATE_TAG` |
| Detach tag from conversation | Remove a tag from a specific conversation in Intercom. | `INTERCOM_DETACH_TAG_FROM_CONVERSATION` |
| Detach tag from ticket | Remove a tag from a ticket in Intercom. | `INTERCOM_DETACH_TAG_FROM_TICKET` |
| Action | What it does | Slug |
| --------------------- | ---------------------------------------------------------------------------------- | -------------------------------- |
| Create ticket | Create a ticket in Intercom to track customer requests and issues. | `INTERCOM_CREATE_TICKET` |
| Enqueue create ticket | Enqueue ticket creation for asynchronous processing. | `INTERCOM_ENQUEUE_CREATE_TICKET` |
| Reply ticket | Reply to a ticket with a message from admin or contact, or with a note for admins. | `INTERCOM_REPLY_TICKET` |
| Update ticket | Update an existing ticket in Intercom. | `INTERCOM_UPDATE_TICKET` |
| Action | What it does | Slug |
| ------------------ | ---------------------------------------------------------------------------------------- | ----------------------------- |
| Create ticket type | Create a new ticket type that defines the data structure for tracking customer requests. | `INTERCOM_CREATE_TICKET_TYPE` |
| Update ticket type | Update an existing ticket type in the workspace. | `INTERCOM_UPDATE_TICKET_TYPE` |
Agents can use 133 of the 133 Intercom actions at this level: everything in **Read + write**, plus:
* Delete articles
* Delete collections
* Delete companies
* Delete contacts
* Update leads
* Delete pages
* Delete tags
* Delete tickets
* Delete visitors
The 14 actions that this level adds to **Read + write**:
| Works on | Action | What it does | Slug |
| ----------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
| **Articles** | Delete an article | You can delete a single article by making a DELETE request to [https://api.intercom.io/articles/\<id](https://api.intercom.io/articles/\<id)>. | `INTERCOM_DELETE_AN_ARTICLE` |
| | Delete internal article | Delete a single internal article by ID. | `INTERCOM_DELETE_INTERNAL_ARTICLE` |
| **Collections** | Delete a collection | You can delete a single collection by making a DELETE request to [https://api.intercom.io/collections/\<id](https://api.intercom.io/collections/\<id)>. | `INTERCOM_DELETE_A_COLLECTION` |
| **Companies** | Delete a company | You can delete a single company. | `INTERCOM_DELETE_A_COMPANY` |
| **Contacts** | Archive contact | Archive a single contact in Intercom. | `INTERCOM_ARCHIVE_CONTACT` |
| | Delete contact | Delete a contact from the Intercom workspace. | `INTERCOM_DELETE_CONTACT` |
| **Content** | Delete content import source | Delete a content import source and all its external pages. | `INTERCOM_DELETE_CONTENT_IMPORT_SOURCE` |
| **Leads** | Merge a lead and a user | You can merge a contact with a role of lead into a contact with a role of user. | `INTERCOM_MERGE_A_LEAD_AND_A_USER` |
| **Pages** | Delete external page | Delete an external page from content library and AI answers. | `INTERCOM_DELETE_EXTERNAL_PAGE` |
| **Subscriptions** | Remove subscription from a contact | You can remove a specific subscription from a contact. | `INTERCOM_REMOVE_SUBSCRIPTION_FROM_A_CONTACT` |
| **Tags** | Delete a tag delete tag | Delete a tag from Intercom workspace. | `INTERCOM_DELETE_A_TAG_DELETE_TAG` |
| | Remove tag from a contact | You can remove tag from a specific contact. | `INTERCOM_REMOVE_TAG_FROM_A_CONTACT` |
| **Tickets** | Delete ticket | Delete a ticket from the Intercom system. | `INTERCOM_DELETE_TICKET` |
| **Visitors** | Delete a visitor | Delete a visitor from the Intercom workspace. | `INTERCOM_DELETE_A_VISITOR` |
## Connect Intercom
Before you start:
* You need an Intercom account that you can sign in to.
* Your Squad subscription must be active. Squad does not connect apps while the subscription is not active.
Open **Settings** > **Integrations**.
On the **Connected apps** tab, click **+ Add integration**.
Find **Intercom** in the catalog and click it. You can type the name in **Search the catalog…**.
Under **Default scope**, choose an access level. This level applies to every agent.
Click **Connect Intercom**. The Intercom sign-in page opens in a new tab.
Sign in to Intercom and approve the request.
Check that it works: Intercom shows under **YOUR CONNECTIONS**, with a row for the account and its access level.
## Change the access level
1. Under **YOUR CONNECTIONS**, find the Intercom account.
2. Open the account menu (⋯) and click **Manage scope**.
3. Under **Default scope**, choose the new level.
4. Click **Save access**.
The change does not need a new sign-in. Agents get the new level from their next call.
## Set access for one agent
Every agent uses the account's level unless you set something else for it. You can narrow one agent to a lower level, or block it.
1. Under **YOUR CONNECTIONS**, open the account menu (⋯) on the Intercom account.
2. Click **Manage scope**.
3. Under **Per-agent access**, find the agent.
4. Choose the **Default** option to follow the account's level, choose a lower level, or choose **No access**.
5. Click **Save access**.
An agent never gets more than the account's level, even if you choose a higher level for it. Changes apply from the agent's next call. An agent with **No access** does not see the account.
## Use more than one Intercom account
Click **+ Account** on the Intercom card to connect another account. Agents use the primary account unless they are asked to use a specific one.
* After you click **+ Account**, follow the connect steps above.
* Each account has its own access level.
* The first account you connect becomes the primary account. It shows **★ PRIMARY**.
* To change the primary account, open the account menu (⋯) and click **Make primary**.
* To tell accounts apart, open the account menu (⋯) and click **Rename**.
## Reconnect or disconnect
Reconnect when the connection has expired, or when you need to change what the account can reach on the Intercom side:
1. Open the account menu (⋯) and click **Reconnect**.
2. Click **Reauthorize on Intercom**.
3. Sign in to Intercom and approve the request.
Reconnect signs in to the same account again. It does not add a second connection.
Open the account menu (⋯) on the Intercom account and click **Disconnect**. Agents lose access to that account at once.
**Disconnect** acts at once, with no confirmation step. If it was the primary account, another connected Intercom account becomes primary.
## Costs
Intercom actions do not use Squad credits. Connected apps never use credits. For what does use credits, see [What Squad costs](/docs/costs).
## Troubleshooting
An agent reports that an action is not allowed on this account.
* Cause: the action is outside the account's access level, or outside the level you set for that agent.
* Fix: choose a higher level in **Manage scope**, or change the agent's row under **Per-agent access**.
An agent says it has no access to Intercom, or it does not see the account.
* Cause: the agent is set to **No access** under **Per-agent access**, or the account is not connected.
* Fix: open **Manage scope** and change the agent's row. If the account is missing, connect it again.
Connecting or saving fails with "Your subscription isn't active."
* Cause: your Squad subscription is not active.
* Fix: resubscribe. See [Manage your subscription](/docs/billing).
An agent says the Intercom connection has expired.
* Cause: the sign-in for that account is no longer valid.
* Fix: use **Reconnect** on the account.
## Common questions
Each Intercom account has an access level: **Read-only**, **Read + write**, and **Full access**. Squad refuses any agent action outside that level. You can also narrow or block single agents under **Per-agent access**.
Click **+ Account** on the Intercom card to connect another account. Agents use the primary account unless they are asked to use a specific one.
Open the account menu (⋯) on the Intercom account and click **Disconnect**. Agents lose access to that account at once.
## Related pages
Use this when an action you need is not in this app.