GET /conversations/{id}
You can fetch the details of a single conversation.
This will return a single Conversation model with all its conversation parts.
{% admonition type="warning" name="Hard limit of 500 parts" %} The maximum number of conversation parts that can be returned via the API is 500. If you have more than that we will return the 500 most recent conversation parts. {% /admonition %}
For AI agent conversation metadata, please note that you need to have the agent enabled in your workspace, which is a paid feature.
Servers
- https://api.intercom.io
- https://api.eu.intercom.io
- https://api.au.intercom.io
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
Integer | Yes |
The id of the conversation to target |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Intercom-Version |
String | No |
Possible values:
Default value: "2.12" |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
display_as |
String | No |
Set to plaintext to retrieve conversation messages in plain text. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.