API & Webhooks

I see there is an API for "List Attached Tags" for contacts but not Companies. Is there a way to pull what tags are associated with a company? Or is the returned on "retrieve a company" or "list all companies"?

I'm trying to search my Contacts by their `id` using the `IN` operator that is listed in API v2.3 reference (https://developers.intercom.com/intercom-api-reference/reference#section-accepted-operatorsThis is my current request payload:```json{ "query": { "operator": "OR", "value": [ { "field": "id", "operator": "IN", "value": ["5fec4b003ba34a1198516369","5fec4b003ba34a11ab516481"] } ] }}``` but I get back an invalid response ```json{ "type": "error.list", "request_id": "000bcmd8o18tsjg9qfq0", "errors": [ { "code": "invalid_field", "message": "_id is not a valid search field" } ]}```It looks like that this field can't be used to search with th

You mention in the Signed Notifications section in the webhooks docs (https://developers.intercom.com/building-apps/docs/webhook-model#section-signed-notifications that the X-Hub-Signature is a sha1 signature of the payload.body and the client secret. Could you please confirm the order both strings are concatenated (payload.body + client_secret) or (client_secret + payload.body) before you pass through sha1()?  Although I've tried both options I'm yet to get a match, but before I look into the possibility of my payload body causing the issue I'd like to get confirmation on the order the two strings should be concatenated. I'm attempting to pass the concatenated string through a sha1() method to do a string comparison with the header value from the request?  Is the usual method to confirm signature or is there something I've missed?

Hola👋  We have intercom integration which is used by our customers and use intercom for ourselves too. Currently we a developing a 'delete account' feature to become GDPR-compliant. So when user in our system requests delete of his theirs data we need to delete it from intercom as well. I assumed that using Access Token for requests gives you all the permissions but seems like I was wrong. When I try to delete a company I get "token_unauthorized". There is a list of permissions in Authentications but AFAIK if I enable delete permissions there they will be requested form our customers who installed our integration too. Is there a way to generate different Permission scopes for API key (internal use) and oAuth (external use)? Thanks in advance for any tips 

We want to track an event, then based on the event triggers an email Stepsend an event from REST APIAdd a rule on the event in order to trigger an emailcheck if the user has received the mail is that possible setting a rule in Intercom?

Hey, this is a question about the conversation_part list field, If I recall , I used to be able to receive the entire thread of messages within a conversation but now I only see the a single message in conversation_parts no matter the length of the thread

Even the example from the help guide (yes, I did enter the API token) doesn't work:curl https://api.intercom.io/articles -X GET -H 'Authorization:Bearer <Your access token>' -H 'Accept:application/json' -H 'Content-Type: application/json' Returns the following error:{"type":"error.list","request_id":"001iuuadd47ehouu9ndg","errors":[{"code":"unauthorized","message":"Access Token Invalid"}]}

We are handling a review process via Intercom, ie. users request a review, we automatically create a conversation and then all discussions about the review should be done inside this specific conversation. now we want to add a button that opens the conversation but I only see a way to create a new conversion or list all open conversations, but I don't see an API call to open a specific conversation (even when its closed). ie. something like Intercom('showConversation', 123)

We are building a platform that helps segment customer feedback. We are wanting to sync the custom attributes from Intercom into our application. We would like to know when custom attributes change on a contact. Is there a webhook for this? or should be periodically poll the API ?

Hi, since a few months there's the ability to do more with company tags, so now I'm wondering if a webhook topic for if a tag is added, would be possible to add :)

Hey Connectors 👋 I'm the Product Manager of the App Ecosystems team at Intercom and we're currently working on defining our focus areas for the coming year. I'm really eager to hear your feedback to understand what's frustrating? What are you hoping to see? And what's missing from our platform across: Building apps for Intercom (incl. Canvas Kit capabilities)APIs / SDKs / WebhooksDeveloper ExperienceIntercom's App store If you're available for a 30min call next week, it would be great to chat and meet some of you.  You can book a time with me here ➡️ https://calendly.com/rati_intercom/intercom-ae-feedback OR share your feedback by replying to this post. (As a note - I'm definitely including feedback you've already provided here and I'd love to hear more!)

Looking to call a function only when the Intercom ( window.Intercom ) object is made available.

Is there a way to get the priority field in conversation objects from webhooks? I could not find a topic for it in the list nor do I get the field as a 'by the way' from any of the other webhooks.

 So far all I can see is `sort & pagination` (search) applies to `contacts` only - but the ability to search articles is what I am looking for - is there a way we can feed in the help centre search results into our apps search results page?  Thank you

When using the Stitchdata integration, what is the difference between the 'Users' and 'Contacts' table? In addition, I'm seeing multiple records created for a single email in the 'Users' and 'Contacts' table. What would cause this to happen? My company is currently using the Stitchdata integration (https://www.stitchdata.com/docs/integrations/saas/intercom) for replicating Intercom data into our warehouse. In the schema, a table titled 'Users' and another titled 'Contacts' exist. What is the difference between these two tables? Also, I see the SAME email being located in both tables. Why is that? Another issue is that, if we are looking at the 'Contacts' table and 'Users' table alone, we see 4-5 records attributed to the same email. Why would this happen?

According to https://developers.intercom.com/building-apps/docs/get-started-developing-on-intercom/u>I have registered in the developer hub.Next I created a developer workspace and created an application. In the application I have ACCESS TOKEN.I am trying to make a simple API request according to https://developers.intercom.com/building-apps/docs/make-an-api-call /u> I send in the console where INTERCOM_ACCESS_TOKEN is Access token on page Authentication in my app in developer-hubI expect to get 200 but get 404. What am I doing wrong?

Suddenly getting unexpected "409 Conflict" errors today due to multiple identical emails even though we are passing unique "user_id" which normally supersedes email. API v1.0 Intercom bug?

I'm looking for a way to trigger a webhook when a note is added to a company. From the documentation this seems like it's not supported, is there a workaround for this?

Hello, are there any ways to rate conversation via API? I want to send rating for conversation via POST-request and I didn't find any endpoint what can I use for it.

We have begun exporting conversation data from the API to calculate our own metrics, and we're running into issues with calculating the metrics correctly. We need help transforming the data to run some great reporting in Looker.  Our data stack is: Intercom <> Hevo <> Snowflake <> Looker For a few examples, here are some top reports we want to create: Volume by TagsConversation DataChannelAgentTimeTo first admin responseBetween follow up replies  Please reach out if you are a consultant who can help or if you have recommendations on how to find an Intercom Data expert! Thank you!  KEYWORDS: Data, Snowflake, Looker, HELP, Consultant, API, Transformation

I'm trying to set up webhooks (conversation.admin.replied for now) and in the body of webhook i get field `data.item.conversation_parts` and it is a list. I don't why this is a list. Can someone please explain it? What I mean - by every reply I get this webhook and info about this reply is stored in a list, but why? Which cases should I handle where it can be a list with length> 1?

My segments are primarily based on user behavior, like, first seen after z date and "has most recent event in past 7 days"  then I query the segments via the API with the count included, like so:get("/segmentID?include_count=true")  but this gives me a non-real time count. It seems to be the count from the last browser session.  So, when I have a new user, I trigger my api call to grab this data and update my dashboards. but the API returns counts as if that new user has not registered. I have to open a browser window with all the segments to get the counts to update.  Is there a timer on which these counts update, or do I have to open a browser to get them to update, or am I doing something wrong?

I am using Development workspaces to try out APIs for development of an App.I would like to use Teams API and have some questions related that. 1, Is it possible to add(invite) or delete teammate via API? 2, When I tried to add teammate using Development workspaces, I got the error in the below capture. Is there any limitation to adding teammate in Development workspaces? 

What's the best way to get a list of company segments from the api? There's only contact segments in the api docs.

From COUNTS documentation: https://developers.intercom.com/intercom-api-reference/reference#conversation-counts/p> But main problem here is that this information is not grouped by companies. Is there way to do some aggregation or grouping by company for conversation statistics?