Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference

REST API

Quick start
Set up SupportWrite the widget copy
getList ConversationsgetList Contact ConversationspatchUpdate Conversation State
Set up ShortlinksCreate short linksSet up Social ProofSocial Proof templatesSet up FeedbackDraft feedback postsSet up ChangelogDraft changelog entriesSet up DisputesSet up Benchmarks
SupportConversations

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.

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://www.saasco.com/api/v2/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": 9007199254740991
  }
]
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Update Widget Copy

Sets the visitor-facing widget copy. Omitted fields stay as they are. Does not change the avatar or the agent label.

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.