Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

Quick StartWhat is Saasco?

Analytics

CRM

Email Marketing

Knowledge

Support

getList Conversation MessagesgetSearch Conversation MessagespostMark Messages SeenpostGet Inbound Email Attachment

Projects

Messages

Search Conversation Messages

Returns conversation ids whose message bodies match every search term. Caps at 200 matches. Does not search contact names, emails, or subjects — those live on the listing and are matched there. Omitted state searches open conversations.

GET
/projects/{projectId}/support/conversations/search

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project whose conversations to search.

Query Parameters

searchrequiredstring

Space-separated terms. Every term must appear somewhere in the thread, though not in one message.

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/search?search=string"
[
  "string"
]
{
  "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": []
}

List Conversation Messages

Returns the transcript of one conversation. Conversation metadata (contact, assignee, state) is on the listing endpoints, not here. Returns 404 if the conversation does not belong to the project.

Mark Messages Seen

Marks customer comments on a conversation as seen by the team. Stamps `seenByTeamAt` on the given message ids that are still unseen. Project-wide, not per member: the first teammate (or API key) to open the thread clears the unread count for everyone.