API & Webhooks

Hi, I'm using the API v2.5 to update a contact as per the docs: https://developers.intercom.com/intercom-api-reference/reference/update-contact/p> This works fine, but for some reason, when I try to update the contact's "avatar" field I've run into this weird issue: If I update with this URL it works fine: "https://img.icons8.com/material/344/user-male-circle--v1.pngquot;. But if I update with this URL, the update succeeds but the avatar field is set to null: "http://res.cloudinary.com/paind/image/upload/v1658396160/user-avatars/zyzlejwogq0oua4nmgwu.

How can I create a Contact with `utm_*` labels via API v2.5?

We are trying to create a contact with the role user, but on sending `external_id` in request, it's not getting returned in the response. Also it doesn't show up in the properties of the created contact in the dashboard. And using the search api with that `external_id` returns no results. Anything we might be doing wrong or some setting we have enable? Here's the request and response object:{ "role": "user", "external_id": "27", "email": "wash@serenity.io", "unsubscribed_from_emails": false, "custom_attributes": { "conversion_score": 0.98, "age_bucket": "0-14" } }{ "type": "contact", "id": "62b55ddacc687ae385777d76", "user_id": "f4e6fa26-a66f-44ad-a9c8-48aae2428a5d", "anonymous": true, "email&q

Getting inconsistent responses using the unstable API version for the export endpoints. I also can't seem to parse the gzip response using any python library? What I am aiming towards is retrieving the chats between clients and admins up to 6 years in the past per client for compliance reasons. Is that possible?

Hi there! I'm a noob when it comes to API stuff, so just still trying to figure it all out.I'm attempting to setup a Zapier hook to pull a total number of conversations with a particular tag on them. Wondering if this is possible? I can see by this https://developers.intercom.com/intercom-api-reference/reference/conversation-counts I'm able to get the total count of conversations, but it doesn't specify if I'm able to also add a filter by tag. For some context that may or not be helpful, for customers that are affected by a bug we'll assign them the relevant bug tag. We can filter by this in reports, but if I can do it as an API call then I can get it into our Notion page which would be super handy. Finally,

I know I can get the entire conversation which contains a list of all the conversation parts but that's overkill for my needs. I have a workflow automation tool that needs to check whether a particular conversation part has already been redacted and would like to get right to that data.

Essentially I have a production workspace and an app linked to it based off the 1.0 API version. I would like to make another app with the latest API version and more permissions and use it to retrieve the data from the same workspace. Will installing this app on the existing workspace break the other app or the workspace itself?

Hey there, I want to pass arbitrary data as custom_attributes to conversations. The update conversation endpoint succeeds but the data is not returned from the retrieve endpoint. Do you know why? Is this property working and if how? Is arbitrary data even allowed or do I have to define this data upfront?

How to send a message through the api to receive a reply from the robot

I am hitting the articles API and it returns the parent id for each article. Here is the article:https://support.tulip.co/en/articles/2280642-how-to-run-an-app-in-the-tulip-player/p>and its parent is:https://support.tulip.co/en/collections/2983157-introduction-getting-started-with-tulip#general-guides/p>which has an ID of 2983157, but when I call that document from the api I get a parent id of 3463139, which isnt a section or collection in my workspace.  Any idea what could be causing this? Pete

Hi, I'm building a custom support page listing articles using API. I saw a report called "Article engagement" with some statistics like "Views", "Conversations" and "Reactions". Is it possible to implement these statistics with API?

Apparently when I do a request for /search endpoints that has many results I receive the HTTP error 429.. e.g:body = { "query": {"field": "updated_at", "operator": ">", "value": 1656362751}, "sort": {"field": "updated_at", "order": "ascending"}, "pagination": {"per_page": 150,}, }   response = request.post(endpoint="https://api.intercom.io/conversations/searchquot;, payload=body)Even if it's only one day of search it leads to that 429 error...

Dear friends,  Do you guys know how can I connect my Intercom data into my MS Powerbi? I've searched and it looks like it is possible to get this done using the rest APIs provided by the Intercom but I'm not managing to access them, can someone help me on this?  Kind regards,

Hello, I am trying to merge contacts leads into users as follow: curl --location --request POST 'https://api.intercom.io/contacts/merge#39; \--header 'Authorization: Bearer toto=' \--header 'Content-Type: application/json' \--header 'Accept: application/json' \--data-raw '{  "from": "623f6320f06ce936269f7bd9",  "to": "6189c5687f416a8308a57a23"}'When I try and query for them individually like this: curl --location --request GET 'https://api.intercom.io/contacts/623f6320f06ce936269f7bd9#39; \--header 'Authorization: Bearer toto=' \--header 'Content-Type: application/json' \--header 'Accept: application/json'

In my current integration, I made an assumption that if a contact was created and associated to a company that contact's company details would come in on the `contact.created` webhook notification. However, I'm no longer convinced that this is ever the case as I see the creation of a contact and attaching it to a company are always done in 2 separate requests in the UI or via API. Is there ever a case where the `contact.created` notification would contain the contact's company details? I haven't been able to make it work even making the attach to company API request in quick succession after creating a contact.  Are there other webhook notifications we could use to know when the contact becomes attached to a company or any other alternative approaches we could use besides polling the contact for updates?

can I have an example !

I use @intercom/intercom-react-native. User is registered with Intercom.registerUnidentifiedUser() and I use Intercom.updateUser({ Tag: 'someTag' })but when I check user in Intercom I see Tag has not been set.

I'm trying to send a new message using "https://developers.intercom.com/intercom-api-reference/reference/admin-initiated-conversation" api and i'm sending `create_conversation_without_contact_reply` key as true in the payload but the response received doesn't contain any conversation_id in it as described in api_documentation. What i trying to do is to get the conversation_id and then instead of sending a new message every time, Send a message as reply to this conversation.Am i missing something here? Or is there any work around available to handle my scenario?

Usecase: We have a requirement to create an canvas app and serve it through an API. I could create an app and also serve it through conversation message from Agent view but I am not quite sure how to send it through API. When I intercept intercom UI (Through network monitor) and how it sends app in conversation it does three things Configures the card Initializes the cardSends the card in conversation {"app_id":"----","conversation_id":"15","blocks":[{"type":"messengerCard","canvas":{"id":"-----" Is there any way to do the same thing using API?

Hi,For create_message and create_conversation have same error. create_message_url = "https://api.intercom.io/messagesquot;create_conversation_url = "https://api.intercom.io/conversationsquot; create_message:{"type":"error.list","request_id":"0000gs3ckh0kbkfn1i4g","errors":[{"code":"server_error","message":"Server Error"}]} create_conversation:{"type":"error.list","request_id":"00b89n0esi3jhj96s2og","errors":[{"code":"server_error","message":"Server Error"}]} Thanks for helping.

Hello, We are using messages API "https://api.intercom.io/messagesquot; to send emails to intercom users from our website.We are trying to send email with HTML but look like API don't support for HTML version. So We have created custom templates into intercom system.  Right now we are looking for to send emails with custom templates, please let us know how we can send emails with template from API. Thanks

I saw another question here, and the answer was referring to tags, but I would like to update the title field of the conversation via API, the update endpoint doesn't seem to work for that.

Since we migrated directly to intercom, there is no phone number attribute, there is a Whatsapp Number attribute on the intercom website but when we use the contact or conversation apis, we are unable to get the Whatsapp Number. How can we get the Whatsapp Number using contact ID ?

Hello!I am trying to create a conversation from a visitor per the doc: https://developers.intercom.com/intercom-api-reference/reference/create-a-conversation I've tried setting `type` to `contact` as indicated. When passing a `user_id` like so: { "from": { "type": "contact", "user_id": "1234567" }, "body": "Hey"} I received the error `Lead Not Found` and the conversation / contact with role lead are not created as expected. How can I create conversations from visitors? Additionally, in an ideal world I would be able to pass a singular user ID (not knowing if this is a visitor or existing

In the API doc: https://developers.intercom.com/intercom-api-reference/reference/conversation-model/p> admin_assignee_id is mentioned as type string, but on api calling it is coming as integer.