Intercom

Learn how to use Intercom with Composio

Overview

SLUG: INTERCOM

Description

Intercom provides live chat, messaging, and customer engagement tools, enabling businesses to drive conversions, handle support, and personalize communication at scale

Authentication Details

client_id
stringRequired
client_secret
stringRequired
full
stringDefaults to https://api.intercom.ioRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to read_user,write_user,read_company,write_company,read_conversation,write_conversation,read_admin,write_admin,read_tag,write_tag,read_event,write_event,read_segment,write_segment,read_count,write_count,read_data_attribute,write_data_attribute,read_ticket,write_ticket,read_team,write_team,read_note,write_note,read_news,write_news,read_article,write_article,read_webhook,write_webhook,offline_access
bearer_token
string

Connecting to Intercom

Create an auth config

Use the dashboard to create an auth config for the Intercom toolkit. This allows you to connect multiple Intercom accounts to Composio for agents to use.

1

Select App

Navigate to the Intercom toolkit page and click “Setup Integration”.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using OAuth2

1from composio import Composio
2from composio.types import auth_scheme
3
4# Replace these with your actual values
5intercom_auth_config_id = "ac_YOUR_INTERCOM_CONFIG_ID" # Auth config ID created above
6user_id = "0000-0000-0000" # UUID from database/application
7
8composio = Composio()
9
10
11def authenticate_toolkit(user_id: str, auth_config_id: str):
12 connection_request = composio.connected_accounts.initiate(
13 user_id=user_id,
14 auth_config_id=auth_config_id,
15 )
16
17 print(
18 f"Visit this URL to authenticate Intercom: {connection_request.redirect_url}"
19 )
20
21 # This will wait for the auth flow to be completed
22 connection_request.wait_for_connection(timeout=15)
23 return connection_request.id
24
25
26connection_id = authenticate_toolkit(user_id, intercom_auth_config_id)
27
28# You can also verify the connection status using:
29connected_account = composio.connected_accounts.get(connection_id)
30print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Intercom toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["INTERCOM"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Attach a contact to a company

Description

You can attach a company to a single contact.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add subscription to a contact

Description

You can add a specific subscription to a contact. in intercom, we have two different subscription types based on user consent - opt-out and opt-in: 1.attaching a contact to an opt-out subscription type will opt that user out from receiving messages related to that subscription type. 2.attaching a contact to an opt-in subscription type will opt that user in to receiving messages related to that subscription type. this will return a subscription type model for the subscription type that was added to the contact.

Action Parameters

consent_type
stringRequired
contact_id
stringRequired
id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add tag to a contact

Description

You can tag a specific contact. this will return a tag object for the tag that was added to the contact.

Action Parameters

contact_id
stringRequired
id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create an article

Description

You can create a new article by making a post request to `https://api.intercom.io/articles`.

Action Parameters

author_id
integerRequired
body
string
description
string
parent_id
integer
parent_type
string
state
string
title
stringRequired
translated__content__ar__author__id
integer
translated__content__ar__body
string
translated__content__ar__created__at
integer
translated__content__ar__description
string
translated__content__ar__state
string
translated__content__ar__title
string
translated__content__ar__type
string
translated__content__ar__updated__at
integer
translated__content__ar__url
string
translated__content__bg__author__id
integer
translated__content__bg__body
string
translated__content__bg__created__at
integer
translated__content__bg__description
string
translated__content__bg__state
string
translated__content__bg__title
string
translated__content__bg__type
string
translated__content__bg__updated__at
integer
translated__content__bg__url
string
translated__content__bs__author__id
integer
translated__content__bs__body
string
translated__content__bs__created__at
integer
translated__content__bs__description
string
translated__content__bs__state
string
translated__content__bs__title
string
translated__content__bs__type
string
translated__content__bs__updated__at
integer
translated__content__bs__url
string
translated__content__ca__author__id
integer
translated__content__ca__body
string
translated__content__ca__created__at
integer
translated__content__ca__description
string
translated__content__ca__state
string
translated__content__ca__title
string
translated__content__ca__type
string
translated__content__ca__updated__at
integer
translated__content__ca__url
string
translated__content__cs__author__id
integer
translated__content__cs__body
string
translated__content__cs__created__at
integer
translated__content__cs__description
string
translated__content__cs__state
string
translated__content__cs__title
string
translated__content__cs__type
string
translated__content__cs__updated__at
integer
translated__content__cs__url
string
translated__content__da__author__id
integer
translated__content__da__body
string
translated__content__da__created__at
integer
translated__content__da__description
string
translated__content__da__state
string
translated__content__da__title
string
translated__content__da__type
string
translated__content__da__updated__at
integer
translated__content__da__url
string
translated__content__de__author__id
integer
translated__content__de__body
string
translated__content__de__created__at
integer
translated__content__de__description
string
translated__content__de__state
string
translated__content__de__title
string
translated__content__de__type
string
translated__content__de__updated__at
integer
translated__content__de__url
string
translated__content__el__author__id
integer
translated__content__el__body
string
translated__content__el__created__at
integer
translated__content__el__description
string
translated__content__el__state
string
translated__content__el__title
string
translated__content__el__type
string
translated__content__el__updated__at
integer
translated__content__el__url
string
translated__content__en__author__id
integer
translated__content__en__body
string
translated__content__en__created__at
integer
translated__content__en__description
string
translated__content__en__state
string
translated__content__en__title
string
translated__content__en__type
string
translated__content__en__updated__at
integer
translated__content__en__url
string
translated__content__es__author__id
integer
translated__content__es__body
string
translated__content__es__created__at
integer
translated__content__es__description
string
translated__content__es__state
string
translated__content__es__title
string
translated__content__es__type
string
translated__content__es__updated__at
integer
translated__content__es__url
string
translated__content__et__author__id
integer
translated__content__et__body
string
translated__content__et__created__at
integer
translated__content__et__description
string
translated__content__et__state
string
translated__content__et__title
string
translated__content__et__type
string
translated__content__et__updated__at
integer
translated__content__et__url
string
translated__content__fi__author__id
integer
translated__content__fi__body
string
translated__content__fi__created__at
integer
translated__content__fi__description
string
translated__content__fi__state
string
translated__content__fi__title
string
translated__content__fi__type
string
translated__content__fi__updated__at
integer
translated__content__fi__url
string
translated__content__fr__author__id
integer
translated__content__fr__body
string
translated__content__fr__created__at
integer
translated__content__fr__description
string
translated__content__fr__state
string
translated__content__fr__title
string
translated__content__fr__type
string
translated__content__fr__updated__at
integer
translated__content__fr__url
string
translated__content__he__author__id
integer
translated__content__he__body
string
translated__content__he__created__at
integer
translated__content__he__description
string
translated__content__he__state
string
translated__content__he__title
string
translated__content__he__type
string
translated__content__he__updated__at
integer
translated__content__he__url
string
translated__content__hr__author__id
integer
translated__content__hr__body
string
translated__content__hr__created__at
integer
translated__content__hr__description
string
translated__content__hr__state
string
translated__content__hr__title
string
translated__content__hr__type
string
translated__content__hr__updated__at
integer
translated__content__hr__url
string
translated__content__hu__author__id
integer
translated__content__hu__body
string
translated__content__hu__created__at
integer
translated__content__hu__description
string
translated__content__hu__state
string
translated__content__hu__title
string
translated__content__hu__type
string
translated__content__hu__updated__at
integer
translated__content__hu__url
string
translated__content__id__author__id
integer
translated__content__id__body
string
translated__content__id__created__at
integer
translated__content__id__description
string
translated__content__id__state
string
translated__content__id__title
string
translated__content__id__type
string
translated__content__id__updated__at
integer
translated__content__id__url
string
translated__content__it__author__id
integer
translated__content__it__body
string
translated__content__it__created__at
integer
translated__content__it__description
string
translated__content__it__state
string
translated__content__it__title
string
translated__content__it__type
string
translated__content__it__updated__at
integer
translated__content__it__url
string
translated__content__ja__author__id
integer
translated__content__ja__body
string
translated__content__ja__created__at
integer
translated__content__ja__description
string
translated__content__ja__state
string
translated__content__ja__title
string
translated__content__ja__type
string
translated__content__ja__updated__at
integer
translated__content__ja__url
string
translated__content__ko__author__id
integer
translated__content__ko__body
string
translated__content__ko__created__at
integer
translated__content__ko__description
string
translated__content__ko__state
string
translated__content__ko__title
string
translated__content__ko__type
string
translated__content__ko__updated__at
integer
translated__content__ko__url
string
translated__content__lt__author__id
integer
translated__content__lt__body
string
translated__content__lt__created__at
integer
translated__content__lt__description
string
translated__content__lt__state
string
translated__content__lt__title
string
translated__content__lt__type
string
translated__content__lt__updated__at
integer
translated__content__lt__url
string
translated__content__lv__author__id
integer
translated__content__lv__body
string
translated__content__lv__created__at
integer
translated__content__lv__description
string
translated__content__lv__state
string
translated__content__lv__title
string
translated__content__lv__type
string
translated__content__lv__updated__at
integer
translated__content__lv__url
string
translated__content__mn__author__id
integer
translated__content__mn__body
string
translated__content__mn__created__at
integer
translated__content__mn__description
string
translated__content__mn__state
string
translated__content__mn__title
string
translated__content__mn__type
string
translated__content__mn__updated__at
integer
translated__content__mn__url
string
translated__content__nb__author__id
integer
translated__content__nb__body
string
translated__content__nb__created__at
integer
translated__content__nb__description
string
translated__content__nb__state
string
translated__content__nb__title
string
translated__content__nb__type
string
translated__content__nb__updated__at
integer
translated__content__nb__url
string
translated__content__nl__author__id
integer
translated__content__nl__body
string
translated__content__nl__created__at
integer
translated__content__nl__description
string
translated__content__nl__state
string
translated__content__nl__title
string
translated__content__nl__type
string
translated__content__nl__updated__at
integer
translated__content__nl__url
string
translated__content__pl__author__id
integer
translated__content__pl__body
string
translated__content__pl__created__at
integer
translated__content__pl__description
string
translated__content__pl__state
string
translated__content__pl__title
string
translated__content__pl__type
string
translated__content__pl__updated__at
integer
translated__content__pl__url
string
translated__content__pt__BR__author__id
integer
translated__content__pt__BR__body
string
translated__content__pt__BR__created__at
integer
translated__content__pt__BR__description
string
translated__content__pt__BR__state
string
translated__content__pt__BR__title
string
translated__content__pt__BR__type
string
translated__content__pt__BR__updated__at
integer
translated__content__pt__BR__url
string
translated__content__pt__author__id
integer
translated__content__pt__body
string
translated__content__pt__created__at
integer
translated__content__pt__description
string
translated__content__pt__state
string
translated__content__pt__title
string
translated__content__pt__type
string
translated__content__pt__updated__at
integer
translated__content__pt__url
string
translated__content__ro__author__id
integer
translated__content__ro__body
string
translated__content__ro__created__at
integer
translated__content__ro__description
string
translated__content__ro__state
string
translated__content__ro__title
string
translated__content__ro__type
string
translated__content__ro__updated__at
integer
translated__content__ro__url
string
translated__content__ru__author__id
integer
translated__content__ru__body
string
translated__content__ru__created__at
integer
translated__content__ru__description
string
translated__content__ru__state
string
translated__content__ru__title
string
translated__content__ru__type
string
translated__content__ru__updated__at
integer
translated__content__ru__url
string
translated__content__sl__author__id
integer
translated__content__sl__body
string
translated__content__sl__created__at
integer
translated__content__sl__description
string
translated__content__sl__state
string
translated__content__sl__title
string
translated__content__sl__type
string
translated__content__sl__updated__at
integer
translated__content__sl__url
string
translated__content__sr__author__id
integer
translated__content__sr__body
string
translated__content__sr__created__at
integer
translated__content__sr__description
string
translated__content__sr__state
string
translated__content__sr__title
string
translated__content__sr__type
string
translated__content__sr__updated__at
integer
translated__content__sr__url
string
translated__content__sv__author__id
integer
translated__content__sv__body
string
translated__content__sv__created__at
integer
translated__content__sv__description
string
translated__content__sv__state
string
translated__content__sv__title
string
translated__content__sv__type
string
translated__content__sv__updated__at
integer
translated__content__sv__url
string
translated__content__tr__author__id
integer
translated__content__tr__body
string
translated__content__tr__created__at
integer
translated__content__tr__description
string
translated__content__tr__state
string
translated__content__tr__title
string
translated__content__tr__type
string
translated__content__tr__updated__at
integer
translated__content__tr__url
string
translated__content__type
string
translated__content__vi__author__id
integer
translated__content__vi__body
string
translated__content__vi__created__at
integer
translated__content__vi__description
string
translated__content__vi__state
string
translated__content__vi__title
string
translated__content__vi__type
string
translated__content__vi__updated__at
integer
translated__content__vi__url
string
translated__content__zh__CN__author__id
integer
translated__content__zh__CN__body
string
translated__content__zh__CN__created__at
integer
translated__content__zh__CN__description
string
translated__content__zh__CN__state
string
translated__content__zh__CN__title
string
translated__content__zh__CN__type
string
translated__content__zh__CN__updated__at
integer
translated__content__zh__CN__url
string
translated__content__zh__TW__author__id
integer
translated__content__zh__TW__body
string
translated__content__zh__TW__created__at
integer
translated__content__zh__TW__description
string
translated__content__zh__TW__state
string
translated__content__zh__TW__title
string
translated__content__zh__TW__type
string
translated__content__zh__TW__updated__at
integer
translated__content__zh__TW__url
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create a collection

Description

You can create a new collection by making a post request to `https://api.intercom.io/help center/collections.`

Action Parameters

description
string
help_center_id
integer
name
stringRequired
parent_id
string
translated__content__ar__description
string
translated__content__ar__name
string
translated__content__ar__type
string
translated__content__bg__description
string
translated__content__bg__name
string
translated__content__bg__type
string
translated__content__bs__description
string
translated__content__bs__name
string
translated__content__bs__type
string
translated__content__ca__description
string
translated__content__ca__name
string
translated__content__ca__type
string
translated__content__cs__description
string
translated__content__cs__name
string
translated__content__cs__type
string
translated__content__da__description
string
translated__content__da__name
string
translated__content__da__type
string
translated__content__de__description
string
translated__content__de__name
string
translated__content__de__type
string
translated__content__el__description
string
translated__content__el__name
string
translated__content__el__type
string
translated__content__en__description
string
translated__content__en__name
string
translated__content__en__type
string
translated__content__es__description
string
translated__content__es__name
string
translated__content__es__type
string
translated__content__et__description
string
translated__content__et__name
string
translated__content__et__type
string
translated__content__fi__description
string
translated__content__fi__name
string
translated__content__fi__type
string
translated__content__fr__description
string
translated__content__fr__name
string
translated__content__fr__type
string
translated__content__he__description
string
translated__content__he__name
string
translated__content__he__type
string
translated__content__hr__description
string
translated__content__hr__name
string
translated__content__hr__type
string
translated__content__hu__description
string
translated__content__hu__name
string
translated__content__hu__type
string
translated__content__id__description
string
translated__content__id__name
string
translated__content__id__type
string
translated__content__it__description
string
translated__content__it__name
string
translated__content__it__type
string
translated__content__ja__description
string
translated__content__ja__name
string
translated__content__ja__type
string
translated__content__ko__description
string
translated__content__ko__name
string
translated__content__ko__type
string
translated__content__lt__description
string
translated__content__lt__name
string
translated__content__lt__type
string
translated__content__lv__description
string
translated__content__lv__name
string
translated__content__lv__type
string
translated__content__mn__description
string
translated__content__mn__name
string
translated__content__mn__type
string
translated__content__nb__description
string
translated__content__nb__name
string
translated__content__nb__type
string
translated__content__nl__description
string
translated__content__nl__name
string
translated__content__nl__type
string
translated__content__pl__description
string
translated__content__pl__name
string
translated__content__pl__type
string
translated__content__pt__BR__description
string
translated__content__pt__BR__name
string
translated__content__pt__BR__type
string
translated__content__pt__description
string
translated__content__pt__name
string
translated__content__pt__type
string
translated__content__ro__description
string
translated__content__ro__name
string
translated__content__ro__type
string
translated__content__ru__description
string
translated__content__ru__name
string
translated__content__ru__type
string
translated__content__sl__description
string
translated__content__sl__name
string
translated__content__sl__type
string
translated__content__sr__description
string
translated__content__sr__name
string
translated__content__sr__type
string
translated__content__sv__description
string
translated__content__sv__name
string
translated__content__sv__type
string
translated__content__tr__description
string
translated__content__tr__name
string
translated__content__tr__type
string
translated__content__type
string
translated__content__vi__description
string
translated__content__vi__name
string
translated__content__vi__type
string
translated__content__zh__CN__description
string
translated__content__zh__CN__name
string
translated__content__zh__CN__type
string
translated__content__zh__TW__description
string
translated__content__zh__TW__name
string
translated__content__zh__TW__type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create a note

Description

You can add a note to a single contact.

Action Parameters

admin_id
string
body
stringRequired
contact_id
string
id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create or update a company

Description

You can create or update a company. companies will be only visible in intercom when there is at least one associated user. companies are looked up via `company id` in a `post` request, if not found via `company id`, the new company will be created, if found, that company will be updated. {% admonition type="attention" name="using `company id`" %} you can set a unique `company id` value when creating a company. however, it is not possible to update `company id`. be sure to set a unique value once upon creation of the company. {% /admonition %}

Action Parameters

company_id
string
custom_attributes
object
industry
string
monthly_spend
integer
name
string
plan
string
remote_created_at
integer
size
integer
website
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete an article

Description

You can delete a single article by making a delete request to `https://api.intercom.io/articles/<id>`.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete a collection

Description

You can delete a single collection by making a delete request to `https://api.intercom.io/collections/<id>`.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete a company

Description

You can delete a single company.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete a contact

Description

You can delete a single contact.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Detach a contact from a company

Description

You can detach a company from a single contact.

Action Parameters

contact_id
stringRequired
id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get a contact

Description

You can fetch the details of a single contact.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Identify an admin

Description

You can view the currently authorised admin along with the embedded app object (a "workspace" in legacy terminology). > 🚧 single sign on > > if you are building a custom "log in with intercom" flow for your site, and you call the `/me` endpoint to identify the logged-in user, you should not accept any sign-ins from users with unverified email addresses as it poses a potential impersonation security risk.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List all activity logs

Description

You can get a log of activities by all admins in an app.

Action Parameters

created_at_after
stringRequired
created_at_before
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List all admins

Description

You can fetch a list of admins for a given workspace.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List all articles

Description

You can fetch a list of all articles by making a get request to `https://api.intercom.io/articles`. > 📘 how are the articles sorted and ordered? > > articles will be returned in descending order on the `updated at` attribute. this means if you need to iterate through results then we'll show the most recently updated articles first.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List all collections

Description

You can fetch a list of all collections by making a get request to `https://api.intercom.io/help center/collections`. collections will be returned in descending order on the `updated at` attribute. this means if you need to iterate through results then we'll show the most recently updated collections first.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List all companies

Description

You can list companies. the company list is sorted by the `last request at` field and by default is ordered descending, most recently requested first. note that the api does not include companies who have no associated users in list responses. when using the companies endpoint and the pages object to iterate through the returned companies, there is a limit of 10,000 companies that can be returned. if you need to list or iterate on more than 10,000 companies, please use the [scroll api](https://developers.intercom.com/reference#iterating-over-all-companies). {% admonition type="warning" name="pagination" %} you can use pagination to limit the number of results returned. the default is `20` results per page. see the [pagination section](https://developers.intercom.com/docs/build-an-integration/learn-more/rest-apis/pagination/#pagination-for-list-apis) for more details on how to use the `starting after` param. {% /admonition %}

Action Parameters

order
string
page
integer
per_page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List all help centers

Description

You can list all help centers by making a get request to `https://api.intercom.io/help center/help centers`.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List all notes

Description

You can fetch a list of notes that are associated to a contact.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List attached companies for contact

Description

You can fetch a list of companies that are associated to a contact.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List attached contacts

Description

You can fetch a list of all contacts that belong to a company.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List attached segments for companies

Description

You can fetch a list of all segments that belong to a company.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List attached segments for contact

Description

You can fetch a list of segments that are associated to a contact.

Action Parameters

contact_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List subscriptions for a contact

Description

You can fetch a list of subscription types that are attached to a contact. these can be subscriptions that a user has 'opted-in' to or has 'opted-out' from, depending on the subscription type. this will return a list of subscription type objects that the contact is associated with. the data property will show a combined list of: 1.opt-out subscription types that the user has opted-out from. 2.opt-in subscription types that the user has opted-in to receiving.

Action Parameters

contact_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List tags attached to a contact

Description

You can fetch a list of all tags that are attached to a specific contact.

Action Parameters

contact_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Merge a lead and a user

Description

You can merge a contact with a `role` of `lead` into a contact with a `role` of `user`.

Action Parameters

from
string
into
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove subscription from a contact

Description

You can remove a specific subscription from a contact. this will return a subscription type model for the subscription type that was removed from the contact.

Action Parameters

contact_id
stringRequired
id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove tag from a contact

Description

You can remove tag from a specific contact. this will return a tag object for the tag that was removed from the contact.

Action Parameters

contact_id
stringRequired
id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve an admin

Description

You can retrieve the details of a single admin.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve an article

Description

You can fetch the details of a single article by making a get request to `https://api.intercom.io/articles/<id>`.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve a collection

Description

You can fetch the details of a single collection by making a get request to `https://api.intercom.io/help center/collections/<id>`.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve a company by id

Description

You can fetch a single company.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve a help center

Description

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>`.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve companies

Description

You can fetch a single company by passing in `company id` or `name`. `https://api.intercom.io/companies?name={name}` `https://api.intercom.io/companies?company id={company id}` you can fetch all companies and filter by `segment id` or `tag id` as a query parameter. `https://api.intercom.io/companies?tag id={tag id}` `https://api.intercom.io/companies?segment id={segment id}`

Action Parameters

company_id
string
name
string
page
integer
per_page
integer
segment_id
string
tag_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Scroll over all companies

Description

The `list all companies` functionality does not work well for huge datasets, and can result in errors and performance problems when paging deeply. the scroll api provides an efficient mechanism for iterating over all companies in a dataset. - each app can only have 1 scroll open at a time. you'll get an error message if you try to have more than one open per app. you can get the first page of companies by simply sending a get request to the scroll endpoint. for subsequent requests you will need to use the scroll parameter from the response type="danger" name="scroll network timeouts". since scroll is often used on large datasets network errors such as timeouts can be encountered. when this occurs you will see a http 500 error with the following message: "request failed due to an internal network error. please restart the scroll operation." if this happens, you will need to restart your scroll query.

Action Parameters

scroll_param
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Search for articles

Description

You can search for articles by making a get request to `https://api.intercom.io/articles/search`.

Action Parameters

help_center_id
integer
highlight
boolean
phrase
string
state
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Set an admin to away

Description

You can set an admin as away for the inbox.

Action Parameters

away_mode_enabled
booleanDefaults to True
away_mode_reassign
boolean
id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update an article

Description

You can update the details of a single article by making a put request to `https://api.intercom.io/articles/<id>`.

Action Parameters

author_id
integer
body
string
description
string
id
integerRequired
parent_id
string
parent_type
string
state
string
title
string
translated__content__ar__author__id
integer
translated__content__ar__body
string
translated__content__ar__created__at
integer
translated__content__ar__description
string
translated__content__ar__state
string
translated__content__ar__title
string
translated__content__ar__type
string
translated__content__ar__updated__at
integer
translated__content__ar__url
string
translated__content__bg__author__id
integer
translated__content__bg__body
string
translated__content__bg__created__at
integer
translated__content__bg__description
string
translated__content__bg__state
string
translated__content__bg__title
string
translated__content__bg__type
string
translated__content__bg__updated__at
integer
translated__content__bg__url
string
translated__content__bs__author__id
integer
translated__content__bs__body
string
translated__content__bs__created__at
integer
translated__content__bs__description
string
translated__content__bs__state
string
translated__content__bs__title
string
translated__content__bs__type
string
translated__content__bs__updated__at
integer
translated__content__bs__url
string
translated__content__ca__author__id
integer
translated__content__ca__body
string
translated__content__ca__created__at
integer
translated__content__ca__description
string
translated__content__ca__state
string
translated__content__ca__title
string
translated__content__ca__type
string
translated__content__ca__updated__at
integer
translated__content__ca__url
string
translated__content__cs__author__id
integer
translated__content__cs__body
string
translated__content__cs__created__at
integer
translated__content__cs__description
string
translated__content__cs__state
string
translated__content__cs__title
string
translated__content__cs__type
string
translated__content__cs__updated__at
integer
translated__content__cs__url
string
translated__content__da__author__id
integer
translated__content__da__body
string
translated__content__da__created__at
integer
translated__content__da__description
string
translated__content__da__state
string
translated__content__da__title
string
translated__content__da__type
string
translated__content__da__updated__at
integer
translated__content__da__url
string
translated__content__de__author__id
integer
translated__content__de__body
string
translated__content__de__created__at
integer
translated__content__de__description
string
translated__content__de__state
string
translated__content__de__title
string
translated__content__de__type
string
translated__content__de__updated__at
integer
translated__content__de__url
string
translated__content__el__author__id
integer
translated__content__el__body
string
translated__content__el__created__at
integer
translated__content__el__description
string
translated__content__el__state
string
translated__content__el__title
string
translated__content__el__type
string
translated__content__el__updated__at
integer
translated__content__el__url
string
translated__content__en__author__id
integer
translated__content__en__body
string
translated__content__en__created__at
integer
translated__content__en__description
string
translated__content__en__state
string
translated__content__en__title
string
translated__content__en__type
string
translated__content__en__updated__at
integer
translated__content__en__url
string
translated__content__es__author__id
integer
translated__content__es__body
string
translated__content__es__created__at
integer
translated__content__es__description
string
translated__content__es__state
string
translated__content__es__title
string
translated__content__es__type
string
translated__content__es__updated__at
integer
translated__content__es__url
string
translated__content__et__author__id
integer
translated__content__et__body
string
translated__content__et__created__at
integer
translated__content__et__description
string
translated__content__et__state
string
translated__content__et__title
string
translated__content__et__type
string
translated__content__et__updated__at
integer
translated__content__et__url
string
translated__content__fi__author__id
integer
translated__content__fi__body
string
translated__content__fi__created__at
integer
translated__content__fi__description
string
translated__content__fi__state
string
translated__content__fi__title
string
translated__content__fi__type
string
translated__content__fi__updated__at
integer
translated__content__fi__url
string
translated__content__fr__author__id
integer
translated__content__fr__body
string
translated__content__fr__created__at
integer
translated__content__fr__description
string
translated__content__fr__state
string
translated__content__fr__title
string
translated__content__fr__type
string
translated__content__fr__updated__at
integer
translated__content__fr__url
string
translated__content__he__author__id
integer
translated__content__he__body
string
translated__content__he__created__at
integer
translated__content__he__description
string
translated__content__he__state
string
translated__content__he__title
string
translated__content__he__type
string
translated__content__he__updated__at
integer
translated__content__he__url
string
translated__content__hr__author__id
integer
translated__content__hr__body
string
translated__content__hr__created__at
integer
translated__content__hr__description
string
translated__content__hr__state
string
translated__content__hr__title
string
translated__content__hr__type
string
translated__content__hr__updated__at
integer
translated__content__hr__url
string
translated__content__hu__author__id
integer
translated__content__hu__body
string
translated__content__hu__created__at
integer
translated__content__hu__description
string
translated__content__hu__state
string
translated__content__hu__title
string
translated__content__hu__type
string
translated__content__hu__updated__at
integer
translated__content__hu__url
string
translated__content__id__author__id
integer
translated__content__id__body
string
translated__content__id__created__at
integer
translated__content__id__description
string
translated__content__id__state
string
translated__content__id__title
string
translated__content__id__type
string
translated__content__id__updated__at
integer
translated__content__id__url
string
translated__content__it__author__id
integer
translated__content__it__body
string
translated__content__it__created__at
integer
translated__content__it__description
string
translated__content__it__state
string
translated__content__it__title
string
translated__content__it__type
string
translated__content__it__updated__at
integer
translated__content__it__url
string
translated__content__ja__author__id
integer
translated__content__ja__body
string
translated__content__ja__created__at
integer
translated__content__ja__description
string
translated__content__ja__state
string
translated__content__ja__title
string
translated__content__ja__type
string
translated__content__ja__updated__at
integer
translated__content__ja__url
string
translated__content__ko__author__id
integer
translated__content__ko__body
string
translated__content__ko__created__at
integer
translated__content__ko__description
string
translated__content__ko__state
string
translated__content__ko__title
string
translated__content__ko__type
string
translated__content__ko__updated__at
integer
translated__content__ko__url
string
translated__content__lt__author__id
integer
translated__content__lt__body
string
translated__content__lt__created__at
integer
translated__content__lt__description
string
translated__content__lt__state
string
translated__content__lt__title
string
translated__content__lt__type
string
translated__content__lt__updated__at
integer
translated__content__lt__url
string
translated__content__lv__author__id
integer
translated__content__lv__body
string
translated__content__lv__created__at
integer
translated__content__lv__description
string
translated__content__lv__state
string
translated__content__lv__title
string
translated__content__lv__type
string
translated__content__lv__updated__at
integer
translated__content__lv__url
string
translated__content__mn__author__id
integer
translated__content__mn__body
string
translated__content__mn__created__at
integer
translated__content__mn__description
string
translated__content__mn__state
string
translated__content__mn__title
string
translated__content__mn__type
string
translated__content__mn__updated__at
integer
translated__content__mn__url
string
translated__content__nb__author__id
integer
translated__content__nb__body
string
translated__content__nb__created__at
integer
translated__content__nb__description
string
translated__content__nb__state
string
translated__content__nb__title
string
translated__content__nb__type
string
translated__content__nb__updated__at
integer
translated__content__nb__url
string
translated__content__nl__author__id
integer
translated__content__nl__body
string
translated__content__nl__created__at
integer
translated__content__nl__description
string
translated__content__nl__state
string
translated__content__nl__title
string
translated__content__nl__type
string
translated__content__nl__updated__at
integer
translated__content__nl__url
string
translated__content__pl__author__id
integer
translated__content__pl__body
string
translated__content__pl__created__at
integer
translated__content__pl__description
string
translated__content__pl__state
string
translated__content__pl__title
string
translated__content__pl__type
string
translated__content__pl__updated__at
integer
translated__content__pl__url
string
translated__content__pt__BR__author__id
integer
translated__content__pt__BR__body
string
translated__content__pt__BR__created__at
integer
translated__content__pt__BR__description
string
translated__content__pt__BR__state
string
translated__content__pt__BR__title
string
translated__content__pt__BR__type
string
translated__content__pt__BR__updated__at
integer
translated__content__pt__BR__url
string
translated__content__pt__author__id
integer
translated__content__pt__body
string
translated__content__pt__created__at
integer
translated__content__pt__description
string
translated__content__pt__state
string
translated__content__pt__title
string
translated__content__pt__type
string
translated__content__pt__updated__at
integer
translated__content__pt__url
string
translated__content__ro__author__id
integer
translated__content__ro__body
string
translated__content__ro__created__at
integer
translated__content__ro__description
string
translated__content__ro__state
string
translated__content__ro__title
string
translated__content__ro__type
string
translated__content__ro__updated__at
integer
translated__content__ro__url
string
translated__content__ru__author__id
integer
translated__content__ru__body
string
translated__content__ru__created__at
integer
translated__content__ru__description
string
translated__content__ru__state
string
translated__content__ru__title
string
translated__content__ru__type
string
translated__content__ru__updated__at
integer
translated__content__ru__url
string
translated__content__sl__author__id
integer
translated__content__sl__body
string
translated__content__sl__created__at
integer
translated__content__sl__description
string
translated__content__sl__state
string
translated__content__sl__title
string
translated__content__sl__type
string
translated__content__sl__updated__at
integer
translated__content__sl__url
string
translated__content__sr__author__id
integer
translated__content__sr__body
string
translated__content__sr__created__at
integer
translated__content__sr__description
string
translated__content__sr__state
string
translated__content__sr__title
string
translated__content__sr__type
string
translated__content__sr__updated__at
integer
translated__content__sr__url
string
translated__content__sv__author__id
integer
translated__content__sv__body
string
translated__content__sv__created__at
integer
translated__content__sv__description
string
translated__content__sv__state
string
translated__content__sv__title
string
translated__content__sv__type
string
translated__content__sv__updated__at
integer
translated__content__sv__url
string
translated__content__tr__author__id
integer
translated__content__tr__body
string
translated__content__tr__created__at
integer
translated__content__tr__description
string
translated__content__tr__state
string
translated__content__tr__title
string
translated__content__tr__type
string
translated__content__tr__updated__at
integer
translated__content__tr__url
string
translated__content__type
string
translated__content__vi__author__id
integer
translated__content__vi__body
string
translated__content__vi__created__at
integer
translated__content__vi__description
string
translated__content__vi__state
string
translated__content__vi__title
string
translated__content__vi__type
string
translated__content__vi__updated__at
integer
translated__content__vi__url
string
translated__content__zh__CN__author__id
integer
translated__content__zh__CN__body
string
translated__content__zh__CN__created__at
integer
translated__content__zh__CN__description
string
translated__content__zh__CN__state
string
translated__content__zh__CN__title
string
translated__content__zh__CN__type
string
translated__content__zh__CN__updated__at
integer
translated__content__zh__CN__url
string
translated__content__zh__TW__author__id
integer
translated__content__zh__TW__body
string
translated__content__zh__TW__created__at
integer
translated__content__zh__TW__description
string
translated__content__zh__TW__state
string
translated__content__zh__TW__title
string
translated__content__zh__TW__type
string
translated__content__zh__TW__updated__at
integer
translated__content__zh__TW__url
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update a collection

Description

You can update the details of a single collection by making a put request to `https://api.intercom.io/collections/<id>`.

Action Parameters

description
string
id
integerRequired
name
string
parent_id
string
translated__content__ar__description
string
translated__content__ar__name
string
translated__content__ar__type
string
translated__content__bg__description
string
translated__content__bg__name
string
translated__content__bg__type
string
translated__content__bs__description
string
translated__content__bs__name
string
translated__content__bs__type
string
translated__content__ca__description
string
translated__content__ca__name
string
translated__content__ca__type
string
translated__content__cs__description
string
translated__content__cs__name
string
translated__content__cs__type
string
translated__content__da__description
string
translated__content__da__name
string
translated__content__da__type
string
translated__content__de__description
string
translated__content__de__name
string
translated__content__de__type
string
translated__content__el__description
string
translated__content__el__name
string
translated__content__el__type
string
translated__content__en__description
string
translated__content__en__name
string
translated__content__en__type
string
translated__content__es__description
string
translated__content__es__name
string
translated__content__es__type
string
translated__content__et__description
string
translated__content__et__name
string
translated__content__et__type
string
translated__content__fi__description
string
translated__content__fi__name
string
translated__content__fi__type
string
translated__content__fr__description
string
translated__content__fr__name
string
translated__content__fr__type
string
translated__content__he__description
string
translated__content__he__name
string
translated__content__he__type
string
translated__content__hr__description
string
translated__content__hr__name
string
translated__content__hr__type
string
translated__content__hu__description
string
translated__content__hu__name
string
translated__content__hu__type
string
translated__content__id__description
string
translated__content__id__name
string
translated__content__id__type
string
translated__content__it__description
string
translated__content__it__name
string
translated__content__it__type
string
translated__content__ja__description
string
translated__content__ja__name
string
translated__content__ja__type
string
translated__content__ko__description
string
translated__content__ko__name
string
translated__content__ko__type
string
translated__content__lt__description
string
translated__content__lt__name
string
translated__content__lt__type
string
translated__content__lv__description
string
translated__content__lv__name
string
translated__content__lv__type
string
translated__content__mn__description
string
translated__content__mn__name
string
translated__content__mn__type
string
translated__content__nb__description
string
translated__content__nb__name
string
translated__content__nb__type
string
translated__content__nl__description
string
translated__content__nl__name
string
translated__content__nl__type
string
translated__content__pl__description
string
translated__content__pl__name
string
translated__content__pl__type
string
translated__content__pt__BR__description
string
translated__content__pt__BR__name
string
translated__content__pt__BR__type
string
translated__content__pt__description
string
translated__content__pt__name
string
translated__content__pt__type
string
translated__content__ro__description
string
translated__content__ro__name
string
translated__content__ro__type
string
translated__content__ru__description
string
translated__content__ru__name
string
translated__content__ru__type
string
translated__content__sl__description
string
translated__content__sl__name
string
translated__content__sl__type
string
translated__content__sr__description
string
translated__content__sr__name
string
translated__content__sr__type
string
translated__content__sv__description
string
translated__content__sv__name
string
translated__content__sv__type
string
translated__content__tr__description
string
translated__content__tr__name
string
translated__content__tr__type
string
translated__content__type
string
translated__content__vi__description
string
translated__content__vi__name
string
translated__content__vi__type
string
translated__content__zh__CN__description
string
translated__content__zh__CN__name
string
translated__content__zh__CN__type
string
translated__content__zh__TW__description
string
translated__content__zh__TW__name
string
translated__content__zh__TW__type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update a company

Description

You can update a single company using the intercom provisioned `id`. {% admonition type="attention" name="using `company id`" %} when updating a company it is not possible to update `company id`. this can only be set once upon creation of the company. {% /admonition %}

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update a contact

Description

You can update an existing contact (ie. user or lead).

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired