API & Webhooks

Get more out of Intercom using our API and webhooks

  • 368 Topics
  • 837 Replies

368 Topics

V
Vidyesh
asked in API & Webhooks

1.How Intercom API handle timestamp in search query ? 2.Respnse data in array is not received in correct order for get all contact API despite mentioning order=desc key in qs.

I am also facing weird kind of issue. what happened in my scenario is that is as below (API V is 2.3).As per docs intercom save timestamp data in UTC formatwhen I pass the UTC timestamp to search API sometimes is does not return any result , but at the same time I pass the timestamp of my local region I got requested data . sometimes it happen vise-versain GET All CONTACT API - when requested sometimes data come in ASC order despite mention order=DESC key in query-params I am not sure what is happening at server but I am sure about date is correctly formatted from ISO string to UTC timestamp. Please kindly provide help.

4
V
2 years ago
A
Ashish A
asked in API & Webhooks

Can I use a custom email address when creating a message using the API?

Hi, I am creating a message using the intercom API. I'm able to send the request, but the recipient sees the sender of the email as: firstname.lastname@company.intercom-mail.com My question is that is it possible to configure intercom so that when the recipient sees the email address of the sender, it is the same as the actual email address of the admin? Rather than companyname.intercom-mail.com? The curl request is below: curl --location --request POST 'https://api.intercom.io/messages#39; \--header 'Authorization: {Bearer token}' \--header 'Content-Type: application/json' \--data-raw '{ "message_type": "email", "subject": "Email subject", "body": "The body of the text message goes here.", "template": "plain", "from": { "type": "admin", "id": "{admin_id}" },  "to": { "type&

1
R
Expert User
2 years ago
R
Rajarajan
asked in API & Webhooks

Do we have filter support for Count API like we do have for Contacts API(/contacts/search)

Hi, I want to create a dashboard based on different filters from Intercom API. I want to have `session_count` and `signed_up_at` filters in Count API. I tried to figure out from the docs but couldn't find any. Please help on this. Any guidance is welcome

1
R
Expert User
2 years ago
U
User401
asked in API & Webhooks

How could I find custom attributes on webhook?

I created a custom attribute on Intercom and I would like to move it to our CRM (Zoho). How would it be visible on webhook?

1
R
Expert User
2 years ago
U
User517
asked in API & Webhooks

Can I send an in-app message to a visitor via api?

Is it possible to send a in-app message to a visitor via api? Before they become a lead or a user. Or, is it possible to convert a visitor to a lead or a user via api then send them an in-app message? I'm trying to trigger an in-app message to a visitor after they fill out a form on my website. We are able to retrieve the Visitor ID using the provide JS and it looks something like this: IntercomVisitorId: [0dd41354-f701-4648-94ca-e24df88dadcc] But I don't know how to use this ID to target the visitor with an in-app message. Thanks!

3
U
2 years ago
R
Robert S12
asked in API & Webhooks

Unable to create note- getting 404 error

Hi, I've mostly managed to navigate the Intercom API without issues. However, I'm struggling to create a note. (I'm using Python, but can replicate the issue with curl.) curl https://api.intercom.io/contacts/5f908d5b37fbb4bceed4c97a/note-X POST -H 'Authorization:Bearer *snip*' -H 'Accept:application/json' -d  { "body": "Shiny", "admin_id": "*snip*"} And I get a 404. Basically, https://api.intercom.io/contacts/lt;intercomid>/note doesn't seem to exist. If I change the URL to https://api.intercom.io/contacts/lt;intercomid>/notes then I get a different error - 400, "Body can't be nil" I am on the latest version (2.3) of the API. Can anyone help please? ThanksRobert

3
R
2 years ago
R
rajabdeenActive User
asked in API & Webhooks

How to get current workspace name?

we can get workspace_id from request body. where we can get the wokspace name? any API available?

2
R
2 years ago
T
Tanay S
asked in API & Webhooks

I am trying to integrate contcats api in our website.For that we are using the api provided by intercom.But for fetching auth token there is param named "Code" which is missing even we are not able to find it's definition or identity what it is.

Api -https://api.intercom.io/auth/eagle/token Params- {"code":"", "client_id": "d0d273fc-d43c-4c2f-b4c9-1e22e43bcb01","client_secret":(VALUE HIDDEN)}in this api "code" what we need to pass in this param,

4
T
2 years ago
F
Fivetran D11
asked in API & Webhooks

Intercom API failing when requesting contacts updated between a specified interval

The connector is failing on the following request:'https://api.intercom.io/contacts/5c0549cebebd285b4fa5426f/tags#39; {"type":"error.list","request_id":"001icr5rttiaof24lkkg","errors":[{"code":"not_found","message":"User Not Found"}]}% We make the following API request to get the contacts updated between a specified interval curl -X POST --data '{"query":{"operator":"AND","value":[{"field":"updated_at","operator":">","value":1591488000},{"field":"updated_at","operator":"<","value":1594080000}]},"pagination":{"per_page":150,"starting_after":"WzE1ODUyNDgzOTAwMDAsIjVlNzg4MzdhMGE3MWI4MmRiZTU0MjMzZSIsMTld"}}' -H 'Authorization: Bearer XXXXX' -H 'Accept: application/json' -H 'Intercom-Vers

2
R
Expert User
2 years ago
Z
Zev
asked in API & Webhooks

Help with Canvas Kit

I'm a newbie, with limited Python knowledge. I built a Canvas Kit, connected to Zapier and SFDC, but not sure how to deploy it live for my team and workspace. Can someone help me? Thanks!

1
C
2 years ago
M
MishaActive User
asked in API & Webhooks

[Webhooks] User in 'user.tag.created' only have old tags after adding a bunch of new ones

Hello, it's me again with the new question about API and webhooks explicitly. I've noticed strange behavior with 'user.tag.created':When you add only one tag at a time - you get user with this tag in tags field. But when I add a bunch of them user doesn't seem to include new ones in 'tags' field.  Below in my payload you can see that created tag (id: 4783953) is not present in user's tags.I want to know is it expected behavior or no? Thanks in advance Here you can see body of my notification: "body": { "type": "notification_event", "app_id": "ep13p0k7", "data": { "type": "notification_event_data", "item": { "type": "user_tag", "user": { "type": "user", "id": "5f8ffb5d6ed4af944328b4dc", "anonymous": false, "email": "lars@mail.com", "name": "Lars Quincy&q

2
M
2 years ago
L
Lauren D11
asked in API & Webhooks

How can I get sending stats on outbound messages I've sent through the API?

I was wondering where the best spot would be to find stats on outbound messages sent via API calls. The info I am looking for is just how many messages are sent out this way per month.

1
R
Expert User
2 years ago
M
MishaActive User
posted in API & Webhooks

forum.intercom.com

Hi, not sure if it's a bug but there are some inconsistencies in webhook notifications. I described some of them here https://forum.intercom.com/s/question/0D52G00004dXbOBSA0/webhooks-user-in-usertagcreated-only-have-old-tags-after-adding-a-bunch-of-new-onesand here https://forum.intercom.com/s/question/0D52G00004dX4uWSAS/different-payloads-for-same-types-from-webhooks-and-rest/p> Currently the biggest concerns for me are: 1) user doesn't have new tags in 'user.tag.created'/'contact.tag.created'; 2) Name is missing in Company in 'company.created' sometimes Thanks in advance 

2
M
2 years ago
V
Vincent G
asked in API & Webhooks

Can we able to work/develop/configure the custom bot through API.

When the visitors initiate the chat , We are collecting basic info from users, Our requirement is,When the users filled our form then we just need to send out our meeting link to the users automatically, Is it doable through Custom Bot or API? If yes, Which API will suits for us? Is there any option to share the room link (3rd party Meeting Link) via intercom. We have their 3rd party API With us, Much appreciated if anyone gives solution,

1
R
Expert User
2 years ago
M
MishaActive User
posted in API & Webhooks

Different payloads for same types from webhooks and REST

For example: Webhook-model has event conversation.user.created which seems to return Conversation type.But if I request the same conversation by id from REST api (i.e. GET /conversations/id) the one from webhook and the one from REST will have different properties . E.g in the webhook's one there is no Source field and not all conversation parts are present. The same goes to contacts If it's intended maybe types from webhook model should be documented separately?

1
M
2 years ago
U
User471
asked in API & Webhooks

Delete user API from version 1.4 still works?

I have around 6000+ test usres in our account and we are about to go live. I have checked and found out that intercom provides delete user API in version 1.4. I have tried the v1.4 user list API and it is working but when I tried the delete usre API, I believe I got the success response. But when I checked the user list API again, I can still see the user and in intercom interface also I can see the same user. So I am confused now that whether the delete user API actually works or not? Can you please confirm? A quick response will be much appreciated.

2
Eric Fitz
2 years ago
U
User461
asked in API & Webhooks

How can I create a Contact with custom attributes? When Iam passing custom attributes , get error response with 500 response code

Api Response  { "type": "error.list", "request_id": "001abpf1ufhhbsgi1ku0", "errors": [   {     "code": "server_error",     "message": "Server Error"   } ]} Value passing  custom_attributes : {"Status": "Active"}

1
L
2 years ago
U
User435
asked in API & Webhooks

Anyone using Segment for data? Their connection with the Intercom API is outdated

Our company uses Looker for data and analytics with our product. The Product team uses all of the different data stats collected from different places to define the product adaption, UX/UI, and Voice of the Customer.We use Segment to collect data from different sources, including Intercom. The issue I'm running into is Segment will not update their Intercom API from 1.x to the newest 2.2 which provides many updates for customer support.We are either going to have to build our own integration directly from Intercom to Looker (not ideal at all) or possibly someone from Intercom can connect with Segment to move this along?

5
B
2 years ago
Ask a question
Terms & ConditionsCookie settings