Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedAgent setupWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference
Skills for agents

REST API

Quick start
getList ConversationsgetList Contact ConversationspatchUpdate Conversation State
SupportConversations

List Conversations

View as MarkdownAgent setup

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.

GET
/projects/{projectId}/support/conversations

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project whose inbox to list.

Query Parameters

afterstring
assigneestring
Value in: "all" | "mine" | "agent"
idsarray<string>
includeSpamboolean
limitinteger
statestring
Value in: "all" | "open" | "closed" | "spam"

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.