Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx

{ "error": "AuthorizationError", "message": "API key inválida." }

{ "error": "InsufficientScope", "message": "API key lacks the required scope: email:send." }

curl -X POST 'https://api.mail.asender.net/v1/emails' \
  -H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 8f7c1e2a-6b3d-4a1e-9c2f-0d5e7a1b2c3d' \
  -d '{
    "from": "joana@empresa.com.br",
    "to": ["cliente@exemplo.test"],
    "subject": "Proposta comercial",
    "text": "Olá, segue a proposta que conversamos. Qualquer dúvida, é só responder."
  }'

{ "message_id": "0b9c…", "status": "sent" }

# 1) a organização de e-mail da conta
curl -s 'https://api.mail.asender.net/orgs' -H 'Authorization: Bearer sk_live_…'
# → {"orgs":[{"id":"<orgID>", …}]}

# 2) o id do domínio
curl -s 'https://api.mail.asender.net/orgs/<orgID>/domains' -H 'Authorization: Bearer sk_live_…'
# → {"domains":[{"id":"<domainID>","domain":"empresa.com.br","active":true, …}]}

# 3) uma caixa por remetente
curl -s -X POST 'https://api.mail.asender.net/domains/<domainID>/mailboxes' \
  -H 'Authorization: Bearer sk_live_…' -H 'Content-Type: application/json' \
  -d '{"local_part":"no-reply","display_name":"Empresa"}'
# → 201 com a caixa criada

{ "error": "QuotaExceeded", "message": "limite MENSAL do plano atingido — suba de plano ou compre créditos para seguir enviando neste ciclo." }

{ "error": "ValidationError", "message": "campo 'to' é obrigatório." }

GET /mailboxes/{id}/messages?limit=50
→ { "messages": [...], "next_cursor": "eyJ…" }

GET /mailboxes/{id}/messages?limit=50&cursor=eyJ…

Ler a assinatura da caixa

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/signature' \
  -H 'Authorization: Bearer SEU_TOKEN'

Gravar a assinatura da caixa (sanitizada no servidor)

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.mail.asender.net/mailboxes/id_AQUI/signature' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Listar a agenda da caixa

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/contacts' \
  -H 'Authorization: Bearer SEU_TOKEN'

Adicionar contato à agenda da caixa

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/contacts' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Apagar contato

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.mail.asender.net/mailboxes/id_AQUI/contacts/contatoId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Atualizar contato

Parâmetros

Respostas

Exemplo

curl -X PATCH 'https://api.mail.asender.net/mailboxes/id_AQUI/contacts/contatoId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Autocomplete de destinatários (catálogo + histórico)

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/recipients/suggest' \
  -H 'Authorization: Bearer SEU_TOKEN'

Configuração automática do Thunderbird (autoconfig, config-v1.1) do domínio

Pelo host da plataforma, com ?emailaddress=. Pública e sem sessão: devolve o XML Mozilla (IMAP 993 SSL/TLS, SMTP 465 SSL/TLS, senha de aplicativo) SÓ para domínio verificado; domínio inexistente, não verificado ou host sem relação respondem o mesmo 404 (sem oráculo). Limite de 60 pedidos por minuto por IP.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/autoconfig/mail/config-v1.1.xml' \
  -H 'Authorization: Bearer SEU_TOKEN'

Configuração automática do Thunderbird (autoconfig, config-v1.1) do domínio

Pelo Host autoconfig.<domínio>, que é o que o Thunderbird chama. Pública e sem sessão: devolve o XML Mozilla (IMAP 993 SSL/TLS, SMTP 465 SSL/TLS, senha de aplicativo) SÓ para domínio verificado; domínio inexistente, não verificado ou host sem relação respondem o mesmo 404 (sem oráculo). Limite de 60 pedidos por minuto por IP.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/mail/config-v1.1.xml' \
  -H 'Authorization: Bearer SEU_TOKEN'

Mudar o tipo da caixa (pessoal ↔ coletiva)

Só uma PESSOA admin do e-mail (sessão com usuário e papel mail:admin); API key e serviço sem usuário = 403. coletiva só para caixa de origem manual/legado (422 origem_automatica/origem_conta_iam). Voltar a pessoal com assinatura ativa = 422 CaixaAssinada. A origem nunca muda. Só caixa coletiva pode ser ligada a um assinante (ADR-0088 D4).

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.mail.asender.net/mailboxes/id_AQUI/tipo' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Enviar a partir de uma caixa específica

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/send' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Enviar e-mail a partir de uma caixa da conta (público)

Exige o escopo email:send (sem ele, 403 InsufficientScope). Envia de uma CAIXA que existe na conta da chave (o domínio verificado não basta: crie a caixa do from antes, pelo painel), assinado com o DKIM do domínio. Para remetente de qualquer endereço de um domínio verificado (incluindo OTP/2FA), use POST https://api.asender.net/v1/emails/send. Idempotente por Idempotency-Key (a mesma chave + tenant não dispara dois e-mails; o replay volta 200 com idempotent_replay:true). Consome a quota de disparos do plano — um por destinatário em to/cc/bcc — e responde 429 quando o teto (diário ou mensal) é atingido. Fora de produção, o piso 18 bloqueia destinos não-allowlistados (o e-mail não sai).

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/v1/emails' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Listar etiquetas da caixa (M-E)

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/labels' \
  -H 'Authorization: Bearer SEU_TOKEN'

Criar etiqueta na caixa

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/labels' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Apagar uma etiqueta (as mensagens perdem só o vínculo)

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.mail.asender.net/mailboxes/id_AQUI/labels/labelId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Renomear/recolorir uma etiqueta

Parâmetros

Respostas

Exemplo

curl -X PATCH 'https://api.mail.asender.net/mailboxes/id_AQUI/labels/labelId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Etiquetas da caixa com origem e contagens (a lateral)

GET /mailboxes/{id}/labels continua compatível; esta rota acrescenta origem/sistema, total e não lidas.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/labels/resumo' \
  -H 'Authorization: Bearer SEU_TOKEN'

Aplicar uma etiqueta a uma mensagem (idempotente)

Etiqueta e mensagem têm de ser da caixa; caso contrário 404 (anti cross-caixa).

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/messages/msgId_AQUI/labels' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Remover uma etiqueta de uma mensagem (idempotente)

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.mail.asender.net/mailboxes/id_AQUI/messages/msgId_AQUI/labels/labelId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Aplicar/remover etiquetas em lote (até 500 mensagens × 20 etiquetas)

Posse dupla por caixa na própria consulta: id de outra caixa é ignorado e não conta. aplicado_por = usuario:<id> com sessão.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/messages/labels' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Aplicar/remover etiquetas em todas as mensagens de uma conversa

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/threads/threadId_AQUI/labels' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Listar identidades de envio da caixa (M-E)

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/identities' \
  -H 'Authorization: Bearer SEU_TOKEN'

Criar identidade de envio (send-as)

O par nome+endereço que a caixa pode usar como "De". O endereço é aceito aqui, mas o ENVIO por ele só passa se o domínio for da org com DKIM verificado (a trava anti-spoofing está no envio).

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/identities' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Apagar uma identidade de envio

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.mail.asender.net/mailboxes/id_AQUI/identities/identityId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Editar uma identidade de envio

Parâmetros

Respostas

Exemplo

curl -X PATCH 'https://api.mail.asender.net/mailboxes/id_AQUI/identities/identityId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

exige administrador e posse do tenant (404 para outro tenant ou caixa já removida, sem vazar existência). Com vínculos (catch-all, encaminhamento/regra de outra caixa que aponta para ela, assinatura do atendimento) recusa com 409 `CaixaComVinculos` + `vinculos` — NÃO limpa o roteamento alheio em silêncio. Com sucesso a caixa deixa de receber (rejeita como inexistente), de autenticar no IMAP/SMTP, some das listas e do "De"; nenhuma mensagem, anexo ou blob é tocado.

Exemplo

curl -X DELETE 'https://api.mail.asender.net/mailboxes/id_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

ApagarAvatarDaCaixa remove a foto.

Exemplo

curl -X DELETE 'https://api.mail.asender.net/mailboxes/id_AQUI/avatar' \
  -H 'Authorization: Bearer SEU_TOKEN'

exigirCaixa (tenant + grant/admin, 404 para quem não pode) e os bytes com os cabeçalhos que impedem a imagem de virar documento na origem do webmail.

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/avatar' \
  -H 'Authorization: Bearer SEU_TOKEN'

só ADMIN do mail no tenant da caixa (exigirAdminNaCaixa); a imagem é decodificada e recodificada em PNG ≤ 256 px ANTES de tocar o blob.

Exemplo

curl -X PUT 'https://api.mail.asender.net/mailboxes/id_AQUI/avatar' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

authz por caixa + DELETE restrito a `custom` e sem conteúdo.

Exemplo

curl -X DELETE 'https://api.mail.asender.net/mailboxes/id_AQUI/folders/fid_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

authz por caixa + UPDATE restrito a `custom`.

Exemplo

curl -X PATCH 'https://api.mail.asender.net/mailboxes/id_AQUI/folders/fid_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

LerForward devolve a regra de encaminhamento da caixa.

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/forwarding' \
  -H 'Authorization: Bearer SEU_TOKEN'

valida o destino (net/mail, no store) e faz UPSERT.

Exemplo

curl -X PUT 'https://api.mail.asender.net/mailboxes/id_AQUI/forwarding' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

decodifica o arquivo, separa nas mensagens, e grava cada uma que a caixa ainda não tem (por Message-ID).

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/import' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

caixa->domínio->tenant + AcharAnexo (scopeado à mensagem/caixa); responde com o conteúdo e Content-Disposition.

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/messages/msgId_AQUI/attachments/attId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

carrega a mensagem (da caixa), acha a chave do From e verifica o clearsign do corpo.

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/messages/msgId_AQUI/pgp-verify' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

ListarChavesPGP devolve as chaves públicas da caixa (fingerprint + uid, sem o

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/pgp/keys' \
  -H 'Authorization: Bearer SEU_TOKEN'

valida o bloco armored no servidor (é chave PÚBLICA? qual a fingerprint?), deriva fingerprint/uid e faz UPSERT por (caixa, endereço).

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/pgp/keys' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

ApagarChavePGP remove uma chave da caixa.

Exemplo

curl -X DELETE 'https://api.mail.asender.net/mailboxes/id_AQUI/pgp/keys/keyId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

exige administrador; acha a removida (404 se ativa/inexistente/outro tenant); 409 `EnderecoEmUso` se uma caixa ativa já tomou o endereço e 409 `DominioRemovido` se o domínio saiu da conta.

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/restaurar' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

LerFerias devolve a regra de férias da caixa (o padrão quando não há).

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/vacation' \
  -H 'Authorization: Bearer SEU_TOKEN'

valida a janela e faz UPSERT.

Exemplo

curl -X PUT 'https://api.mail.asender.net/mailboxes/id_AQUI/vacation' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Pastas da caixa, com total e não-lidas

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/folders' \
  -H 'Authorization: Bearer SEU_TOKEN'

Criar pasta do usuário (kind=custom)

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/folders' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Listar mensagens da caixa (por pasta, marcadores e busca)

Paginada por cursor opaco. O escopo é sempre a caixa da rota — a query recorta, nunca amplia. Cursor inválido/velho volta à primeira página em vez de virar erro.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/messages' \
  -H 'Authorization: Bearer SEU_TOKEN'

Ler a mensagem completa (marca como lida)

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/messages/msgId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Marcar lida, estrelar ou mover uma mensagem

Parâmetros

Respostas

Exemplo

curl -X PATCH 'https://api.mail.asender.net/mailboxes/id_AQUI/messages/msgId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Liberar uma mensagem da Quarentena para a Entrada (ADR-0087)

Achado heurístico/PUA (Heuristics.*, PUA.*): quem tem a caixa libera. Achado de ASSINATURA (descoberto no reexame): só o admin (403 para os demais). Exige {"confirmo": true}. A liberação é auditada (quem, quando, qual assinatura) e NÃO muda o veredito: a mensagem continua infectado, e o download dos anexos exige aceito_risco=1. O PATCH de pasta recusa sair da Quarentena (409) — esta é a única saída.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/messages/msgId_AQUI/quarantine/release' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Baixar o .eml original (ADR-0028)

O bruto guardado sai byte a byte como chegou; à FRENTE dele, numa mensagem recebida, vão cabeçalhos SINTETIZADOS do veredito gravado (ADR-0087): X-Spam-Flag (YES quando a mensagem está hoje na pasta Spam), X-Spam-Status, X-Spam-Score, X-Spam-Action e X-Spam-Symbols (quando o motor de conteúdo opinou) e o Authentication-Results que geramos. Cabeçalhos acrescentados no topo não invalidam a assinatura DKIM.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/messages/msgId_AQUI/raw' \
  -H 'Authorization: Bearer SEU_TOKEN'

Reexaminar agora uma mensagem pendente ou não verificada (ADR-0087)

Roda o antivírus sobre o .eml guardado e grava o veredito; malware vai para a Quarentena (heurística conforme a política da org). Teto de 10 por minuto por caixa (429). Scanner fora → 503 e a mensagem continua pendente (o reexame automático tenta de novo). Mensagem já verificada (limpo/infectado) ou sem o original guardado → 409.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/messages/msgId_AQUI/rescan' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Aplicar a mesma alteração a várias mensagens

A autorização é por CAIXA; dentro dela cada id é conferido. Id que não pertence à caixa volta em negados (não é aplicado nem ignorado em silêncio). Máximo de 500 ids.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/messages/batch' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Filtrar parecidos — o que as mensagens escolhidas têm em comum, como critérios de busca

Critérios ordenados por cobertura (quantas das escolhidas pegam) e especificidade: remetente exato, conjunto de remetentes, padrão do endereço (de:no-reply@), domínio(s), domínio registrável, List-Id, começo/palavras comuns do assunto, destinatário, Cc, anexo; Reply-To aparece sem busca (não é campo de busca), com motivo. sugerido marca a combinação pré-marcada e busca_sugerida a junta. total é quantas mensagens da caixa a busca do critério acha. Ids de outra caixa são ignorados.

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/messages/parecidos' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Conversa agrupada (threading, M-C)

Todas as mensagens da thread, em ordem cronológica (mais antiga primeiro), com as imagens inline (cid:) já embutidas como data:. Escopo por caixa: a thread de outra caixa não é alcançável nem com o uuid.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/threads/threadId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Criar rascunho (auto-save do compositor)

Parâmetros

Respostas

Exemplo

curl -X POST 'https://api.mail.asender.net/mailboxes/id_AQUI/drafts' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Descartar rascunho

Parâmetros

Respostas

Exemplo

curl -X DELETE 'https://api.mail.asender.net/mailboxes/id_AQUI/drafts/draftId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Retomar rascunho

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/mailboxes/id_AQUI/drafts/draftId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN'

Atualizar rascunho

Parâmetros

Respostas

Exemplo

curl -X PUT 'https://api.mail.asender.net/mailboxes/id_AQUI/drafts/draftId_AQUI' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid-v4>' \
  -d '{ }'

Resumo da ferramenta para o hub e a home (contrato comum de resumo).

Sobre as caixas que a PESSOA recebeu por concessão (e-mail é por caixa, não por conta): número de caixas, não lidos da Entrada (agora), recebidos e enviados na janela (com a anterior) e as séries por dia. Com API key (máquina, sem usuário), todas as caixas ativas da conta. Tenant e usuário vêm da credencial verificada, nunca da query. Conta alheia → 404; membro sem acesso ao produto → 403.

Parâmetros

Respostas

Exemplo

curl -X GET 'https://api.mail.asender.net/v1/resumo' \
  -H 'Authorization: Bearer SEU_TOKEN'