List email conversations

get /v1/emails

Conversations are deduplicated across every mailbox connected to the company: two sellers on the same thread yield one conversation with two mailboxes. Ordered by last_message_at ascending (oldest activity first); pages forward with a signed keyset cursor. Message bodies live under /v1/emails/{email_id}/messages and need emails.content.read. account_id keeps the conversations linked to that account. team_id keeps the conversations whose mailbox owner is a member of that team, a seller counting for their default team only.

Autorização

Exige o escopo emails.read.

Parâmetros de query

Nome	Tipo	Obrigatório	Descrição
`limit`	`integer`	Não	Records per page, 1 to 100. A page may return fewer than this while has_more is still true; drive the loop by has_more, not by the size of data.
`cursor`	`string`	Não	Signed cursor returned by the previous page.
`last_message_after`	`string date-time`	Não	Return conversations whose latest message is after this instant. Filters on activity, not on record changes: a conversation that gains a message moves forward and will be seen again.
`last_message_before`	`string date-time`	Não	Return conversations whose latest message is before this instant.
`account_id`	`string`	Não	Return only records linked to this account. Take the id from `GET /v1/accounts` or from an `accounts` field. An id the company never issued, or one issued to another company, yields an empty page, not an error; a malformed id is a 400 `INVALID_FILTER`.
`team_id`	`string`	Não	Return only records owned by a member of this team. Members are the sellers whose default team it is: a seller in several teams counts for their default team only. Take the id from `GET /v1/teams`. An id the company never issued, one issued to another company, or a team with no members yields an empty page, not an error; a malformed id is a 400 `INVALID_FILTER`.

Exemplo de requisição

curl "https://api.salesbud.com.br/v1/emails?limit=...&cursor=..." \
  -H "Authorization: Bearer $SALESBUD_ACCESS_TOKEN"

Exemplo de resposta

{
  "data": [
    {
      "id": "eml_01JEXAMPLE",
      "object": "email_conversation",
      "subject": "Assunto de exemplo",
      "first_message_at": "2026-01-10T12:00:00.000Z",
      "last_message_at": "2026-01-12T15:30:00.000Z",
      "message_count": 3,
      "has_attachments": true,
      "last_message_direction": "inbound",
      "participants": [
        {
          "address": "vendedora@example.com",
          "name": "Vendedora Exemplo",
          "internal": true
        },
        {
          "address": "cliente@example.net",
          "name": "Cliente Exemplo",
          "internal": false
        }
      ],
      "mailboxes": [
        {
          "address": "vendedora@example.com",
          "owner": {
            "id": "usr_01JEXAMPLE",
            "name": "Vendedora Exemplo",
            "email": "vendedora@example.com"
          }
        },
        {
          "address": "vendas@example.com",
          "owner": null
        }
      ],
      "accounts": [
        {
          "id": "acc_01JEXAMPLE",
          "name": "Example Ltda",
          "domain": "example.net",
          "cnpj": "00.000.000/0001-00"
        }
      ]
    }
  ],
  "pagination": {
    "limit": 50,
    "has_more": true,
    "next_cursor": "cur_ExampleCursor03"
  },
  "request_id": "req_ExampleRequestId01"
}

Respostas

Status	Descrição
`200`	Company-scoped email conversation page.
`400`	Invalid request.
`401`	Missing or invalid credentials.
`403`	The token lacks the required scope, its user owner lost matching product access, or a connector awaits administrator approval. API_ACCESS_DISABLED identifies the feature gate for manual clients and third-party OAuth apps; AI_COLLABORATORS_DISABLED identifies the gate for first-party OAuth apps. For partner credentials, the gate also requires an active partner and the required published module, and applies to previously issued tokens.
`429`	Client rate limit exceeded.
`503`	A required audit or rate-limit dependency is unavailable.