Get an email conversation

get /v1/emails/{email_id}

Conversation metadata only. An eml_ id issued to another company, or any id with a different prefix, is a 404, not a hint.

Autorização

Exige o escopo emails.read.

Parâmetros de caminho

Nome	Tipo	Obrigatório	Descrição
`email_id`	`string`	Sim	—

Exemplo de requisição

curl "https://api.salesbud.com.br/v1/emails/mtg_01JEXAMPLE" \
  -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"
      }
    ]
  },
  "request_id": "req_ExampleRequestId01"
}

Respostas

Status	Descrição
`200`	Company-scoped email conversation.
`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.
`404`	Resource not found in the authenticated company, or outside what the owner of a user credential can see.
`429`	Client rate limit exceeded.
`503`	A required audit or rate-limit dependency is unavailable.