Intercom Email API

Sending a GET request to the URL - the {job_identifier} is the value returned in the response when you first created the export job. More on it can be seen in the Export Job Model.🚧 Jobs expire after two days All jobs that have completed processing (and are thus available to download from the provided URL) will have an expiry limit of two days from when the export ob completed. After this, the data will no longer be available.Pathjob_identifierstringrequiredHeadersIntercom-Versionstring(intercom_version)Intercom API version.By default, it's equal to the version set in the app package. Default 2.7 Enum"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4" Example: 2.7curl -i -X GET \ ' \ -H 'Authorization: Bearer ' \ -H 'Intercom-Version: 2.7'ResponsesBodyapplication/jsonjob_identfierstringThe identifier for your job. Example: "orzzsbd7hk67xyu"statusstringThe current state of your job. Enum"pending""in_progress""failed""completed""no_data""canceled" Example: "pending"download_expires_atstringThe time after which you will not be able to access the data. Example: "1674917488"download_urlstringThe location where you can download your data. Example: " "job_identifier": "pr4wk1i72aosuh3f", "status": "pending", "download_url": "", "download_expires_at": ""}Was this page helpful?Cancel content data exportRequestPathjob_identifierstringrequiredHeadersIntercom-Versionstring(intercom_version)Intercom API version.By default, it's equal to the version set in the app package. Default 2.7 Enum"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4" Example: 2.7curl -i -X POST \ ' \ -H 'Authorization: Bearer ' \ -H 'Intercom-Version: 2.7'ResponsesBodyapplication/jsonjob_identfierstringThe identifier for your job. Example: "orzzsbd7hk67xyu"statusstringThe current state of your job. Enum"pending""in_progress""failed""completed""no_data""canceled" Example: "pending"download_expires_atstringThe time after which you will not be able to access the data. Example: "1674917488"download_urlstringThe location where you can download your data. Example: " "job_identifier": "evqjvuxwubf3z6e4", "status": "canceled", "download_url": "", "download_expires_at": ""}Was this page helpful?Download content data exportRequestWhen a job has a status of complete, and thus a filled download_url, you can download your data by hitting that provided URL, formatted like so: exported message data will be streamed continuously back down to you in a gzipped CSV format.📘 Octet header requiredYou will have to specify the header Accept: application/octet-stream when hitting this endpoint.Pathjob_identifierstringrequiredHeadersIntercom-Versionstring(intercom_version)Intercom API version.By default, it's equal to the version set in the app package. Default 2.7 Enum"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4" Example: 2.7curl -i -X GET \ ' \ -H 'Authorization: Bearer ' \ -H 'Intercom-Version: 2.7'ResponsesWas this page helpful?Help CenterEverything about your Help CenterOperationsMessagesEverything about your messagesOperationsNewsEverything about your NewsOperationsNotesEverything about your NotesOperationsSegmentsEverything about your SegmentsOperationsSubscription TypesEverything about subscription typesOperationsTeamsEverything about your TeamsOperationsVisitorsEverything about your VisitorsOperationsModels

To self-serve.Jackson RostagnoCustomer Service Manager, Bailey NelsonThe best thing about Intercom is its seamless blend of automation, AI, and conversational customer support. It allows us to respond faster, while empowering customers to self-serve.Jackson RostagnoCustomer Service Manager, Bailey Nelson4We shape the industryIntercom has always invented products that change the industry. And we ship faster than anyone.We invented the world's first messenger for customer service. We invented the world's first AI Agent. We invented the world's first AI Copilot for customer service agents.With Intercom, you—and your customers—will always get the latest innovations.We ship new AI innovations every week2023 Q158 Features ShippedImproving the HC and Articles: Part IINew re-designed Help Center Settings pageHC Customization - Multi-level categoriesArticle Version RestoringArticle Version ComparisonArticles Views/Lists and Management‘After a customer sends any message’ triggerWorkflows: ‘Apply rules’ stepWorkflows: Rename action steps in workflowsWorkflows: Rules in Custom BotsCustom Bots Reporting by Workflow triggerWorkflow Builder full screenWorkflows - Inactivity & SnoozeChart Builder improvements for Custom ReportsTeam Performance report metricsOmnichannel BotsConversation Topics in WorkflowsLanguage detection in botsResolution Bot to Custom Bot handoverFile uploads for Tickets in the inboxAllow replies to closed email conversationsCentralised channels hubEmail forwardingManage participants without sending a replyEmail end-user automatic detectionTicket titles and descriptionsSide by side view of tickets & conversationsImprove the inbox experience: rich textDifferentiating tickets and conversationsLinked Tickets refreshed UIForward emails externally improvementsImprove email appearance in InboxTurning off inbox teammate presenceFile Uploads (Web)Developer documentation improvementsTickets CSV ExportTickets API (Retrieve & Update)Tickets in Custom ActionsCustom Objects: Reference AttributesChecklists fast followsLink BrandingSubpaths for Help Center’s custom domainHC Customisation - Collection card redesignHC Customization - Multi-level categoriesColumn layout options in help centerAdd links to help center headerAdd contact details to help center footerBackground & text colour for header & footerArticle formatting improvementsSearch & filter messages improvementsEmail deliverability notificationTable of Contents for Help CenterMessenger Settings IAPotential Duplicates in the InboxPhone

In order to use API, you need proper authentication, with the access token. You have all the details here: Hello @rodrigo m12​ 👋, Can you share a bit more information? Which metrics are you want to track via PowerBI? Hello @roy s11​ , I'd like to collect the conversations details (responses, first answer time, tags, etc). I know I can check all these info at the reports section, but I'd like to bring these info and connect with other data sources (like my CRM, for example) to create richer dashboards.I just do not know exactly how I make the proper authentication.I created an app on my Dev Hub called PowerBI: And when I access it, I have the following information:My access token, and also my CLIENT ID, CLIENT SECRET.: To connect to PowerBI, I'm trying to insert the rest APIs urls in the Web Data Source, on the app: (I don't know exactly what should I insert here)And I also don't know how can I access the web content:Should I do it anonymously? Should I insert basic credentials (my email/password from intercom or my CLIENT ID / CLIENT SECRET)?I'm getting stucked in this part.Any help is much appreciated.Thank you very much! Hi @rodrigo m12​ We found a solution about it. 1- You should decide which modules you'll use. You can check > Then you need to proper your autentication as everyone said. You can do it from intercom developer hub. About your choices you can do itPowerbi is supporting connection

The intercom API reference.The production API serverThe european API server australian API server about your AdminsOperationsArticlesEverything about your ArticlesOperationsCompaniesEverything about your CompaniesOperationsConversationsEverything about your ConversationsOperationsData AttributesEverything about your Data AttributesOperationsData EventsEverything about your Data EventsOperationsEverything about your Data ExportsOperationsData ExportThe data export api is used to view all message sent & viewed in a given timeframe.job_identfierstringThe identifier for your job. Example: "orzzsbd7hk67xyu"statusstringThe current state of your job. Enum"pending""in_progress""failed""completed""no_data""canceled" Example: "pending"download_expires_atstringThe time after which you will not be able to access the data. Example: "1674917488"download_urlstringThe location where you can download your data. Example: " "job_identfier": "orzzsbd7hk67xyu", "status": "pending", "download_expires_at": "1674917488", "download_url": " content data exportRequestTo create your export job, you need to send a POST request to the export endpoint only parameters you need to provide are the range of dates that you want exported.🚧 Limit of one active jobYou can only have one active job per workspace. You will receive a HTTP status code of 429 with the message Exceeded rate limit of 1 pending message data export jobs if you attempt to create a second concurrent job.❗️ Updated_at not includedIt should be noted that the timeframe only includes messages sent during the time period and not messages that were only updated during this period. For example, if a message was updated yesterday but sent two days ago, you would need to set the created_at_after date before the message was sent to include that in your retrieval job.📘 Date ranges are inclusiveRequesting data for 2018-06-01 until 2018-06-30 will get all data for those days including those specified - e.g. 2018-06-01 00:00:00 until 2018-06-30 23:59:99.HeadersIntercom-Versionstring(intercom_version)Intercom API version.By default, it's equal to the version set in the app package. Default 2.7 Enum"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4" Example: 2.7Bodyapplication/jsoncreated_at_afterintegerrequiredThe start date that you request data for. It must be formatted as a unix timestamp. Example: 1527811200created_at_beforeintegerrequiredThe end date that you request data for. It must be formatted as a unix timestamp. Example: 1527811200curl -i -X POST \ \ -H 'Authorization: Bearer ' \ -H 'Content-Type: application/json' \ -H 'Intercom-Version: 2.7' \ -d '{ "created_at_after": 1717002906, "created_at_before": 1717020906 }'ResponsesBodyapplication/jsonjob_identfierstringThe identifier for your job. Example: "orzzsbd7hk67xyu"statusstringThe current state of your job. Enum"pending""in_progress""failed""completed""no_data""canceled" Example: "pending"download_expires_atstringThe time after which you will not be able to access the data. Example: "1674917488"download_urlstringThe location where you can download your data. Example: " "job_identifier": "qwwuh4z5ird2xyuu", "status": "pending", "download_url": "", "download_expires_at": ""}Was this page helpful?Show content data exportRequestYou can view the status of your job by