API Reference
- Contacts
- Accounts
- Feedback
- Conversations
Conversations
Submit a conversation
Submits conversation data to the system for processing. This can be content like a call transcript, email thread, or chat conversation.
POST
/
conversations
Copy
Ask AI
curl --request POST \
--url https://insights.reforge.com/api/v1/conversations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"id": "conversation-123",
"source": "intercom",
"createdAt": "2024-01-01T00:00:00.000Z",
"contacts": [
{
"id": "<string>",
"shouldUnflattenProperties": true,
"properties": {
"$email": "<string>",
"$name": "<string>",
"$createdAt": "2023-11-07T05:31:56Z",
"$updatedAt": "2023-11-07T05:31:56Z"
},
"account": {
"id": "account-789",
"shouldUnflattenProperties": true,
"properties": {
"$name": "Acme, Inc.",
"$domain": "acme.com",
"$createdAt": "2023-11-07T05:31:56Z",
"$updatedAt": "2023-11-07T05:31:56Z",
"$contractValue": 100000
}
}
}
],
"messages": [
{
"id": "message-789",
"incoming": true,
"contactId": "user-456",
"content": "Hello! I'\''m having trouble...",
"createdAt": "2024-01-01T00:00:00.000Z",
"shouldUnflattenProperties": true,
"properties": {}
}
],
"shouldUnflattenProperties": true,
"properties": {}
}'
Copy
Ask AI
{
"success": true
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
Response
200
application/json
Conversation submitted successfully.
The response is of type object
.
Copy
Ask AI
curl --request POST \
--url https://insights.reforge.com/api/v1/conversations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"id": "conversation-123",
"source": "intercom",
"createdAt": "2024-01-01T00:00:00.000Z",
"contacts": [
{
"id": "<string>",
"shouldUnflattenProperties": true,
"properties": {
"$email": "<string>",
"$name": "<string>",
"$createdAt": "2023-11-07T05:31:56Z",
"$updatedAt": "2023-11-07T05:31:56Z"
},
"account": {
"id": "account-789",
"shouldUnflattenProperties": true,
"properties": {
"$name": "Acme, Inc.",
"$domain": "acme.com",
"$createdAt": "2023-11-07T05:31:56Z",
"$updatedAt": "2023-11-07T05:31:56Z",
"$contractValue": 100000
}
}
}
],
"messages": [
{
"id": "message-789",
"incoming": true,
"contactId": "user-456",
"content": "Hello! I'\''m having trouble...",
"createdAt": "2024-01-01T00:00:00.000Z",
"shouldUnflattenProperties": true,
"properties": {}
}
],
"shouldUnflattenProperties": true,
"properties": {}
}'
Copy
Ask AI
{
"success": true
}
Assistant
Responses are generated using AI and may contain mistakes.