List Conversations
Lists Support inbox conversations (chat and email) with a preview line and unread count, not the transcript. Filter by state; omitted state returns open conversations. open and closed exclude spam. all includes spam unless includeSpam is false. spam lists only quarantined threads.
Authorization
Authorization In: header
Path Parameters
ID of the project whose inbox to list.
Query Parameters
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/projects/string/support/conversations"[ { "id": "string", "createdAt": "string", "updatedAt": "string", "projectId": "string", "contactId": "string", "anonymousEmail": "string", "state": "open", "subject": "string", "source": "email", "snoozedUntil": "string", "ownerChangedAt": "string", "assignedToUserId": "string", "assignee": { "email": "string", "id": "string", "image": "string", "name": "string" }, "contact": { "id": "string", "createdAt": "string", "updatedAt": "string", "projectId": "string", "distinctId": "string", "email": "string", "toDelete": true, "properties": { "age": 0, "avatar": "http://example.com", "birthday": "string", "createdAt": "string", "description": "string", "displayName": "string", "email": "user@example.com", "firstName": "string", "gender": "string", "id": "string", "lastName": "string", "name": "string", "phone": "string", "title": "string", "username": "string", "website": "string", "$id": "string", "$lastSeen": "string", "$lastIdentifiedAt": "string", "$processedAt": "string", "$unsubscribed": true, "$subscribed": true, "$unsubscribeReason": "manual", "$unsubscribeSource": "string", "$emailValidated": true, "$lastEmailValidatedAt": "string", "$emailValidationResult": "string", "$emailScore": 0, "$stripeCustomerId": "string", "$os": "string", "$browser": "string", "$browserVersion": "string", "$screenHeight": 0, "$screenWidth": 0, "$screenDpi": 0, "$device": "string", "$userAgent": "string", "$ip": "string", "$timezone": "string", "$city": "string", "$country": "string", "$countryCode": "string", "$continent": "string", "$region": "string", "$locale": "string", "$latitude": 0, "$longitude": 0, "$referrer": "string", "$referringDomain": "string", "$initialReferrer": "string", "$initialReferringDomain": "string", "$utmSource": "string", "$utmMedium": "string", "$utmCampaign": "string", "$utmTerm": "string", "$utmContent": "string", "$initialUtmSource": "string", "$initialUtmMedium": "string", "$initialUtmCampaign": "string", "$initialUtmTerm": "string", "$initialUtmContent": "string", "$_toDelete": true, "$_emailScoreActions": "string", "property1": "string", "property2": "string" } }, "owner": "agent", "lastMessage": { "authorRole": "user", "createdAt": "string", "id": "string", "preview": "string" }, "unseenCustomerMessageCount": 0 }]Update Support Widget Settings
Updates Support widget settings in one save and returns the complete settings payload. Omitted fields, including nested fields, stay unchanged. Trusted domains replace the current list; entries must be bare hostnames. A support mailbox domain must belong to this project and be ready to send and receive. Null mailbox.supportDomain clears it. Set any launcher field to null to remove its saved override and restore the default; omitted launcher fields stay unchanged. Does not change credentials or notification recipients.
List Contact Conversations
Lists every Support conversation for one CRM contact, including closed and spam threads. Each row is the same listing shape as List Conversations: a preview line, not the transcript.