Pular para o conteúdo
Voltar para a home

Começar

Quickstart cURL

Para testes rápidos, scripts shell ou integração CI/CD. Substitua $JETSEND_KEY pela sua chave.

1. Instalação

shell
# Nada para instalar. cURL já vem em macOS/Linux/WSL.export JETSEND_KEY=sm_live_...

2. Enviar o primeiro e-mail

shell
curl -X POST https://api.jetsend.com.br/v1/messages \  -H "Authorization: Bearer $JETSEND_KEY" \  -H "Content-Type: application/json" \  -d '{    "from": "no-reply@suaempresa.com.br",    "fromName": "Sua Empresa",    "to": "cliente@exemplo.com",    "subject": "Bem-vindo!",    "html": "<h1>Olá!</h1><p>Sua conta foi criada.</p>"  }'

Para exercitar devolução e reclamação sem gastar reputação, troque o destinatário por um apelido de teste.

3. Listar mensagens

shell
curl "https://api.jetsend.com.br/v1/messages?limit=50&status=delivered" \  -H "Authorization: Bearer $JETSEND_KEY"

4. Criar chave de API

shell
curl -X POST https://api.jetsend.com.br/v1/api-keys \  -H "Authorization: Bearer $JETSEND_KEY" \  -H "Content-Type: application/json" \  -d '{"name": "Produção webhook"}'# IMPORTANTE: o campo "key" só aparece nesta resposta. Guarde com segurança.

A chave aparece uma vez só. O que cada tipo de chave pode fazer está em Autenticação.

5. Verificar domínio

shell
# 1) Cadastrar domíniocurl -X POST https://api.jetsend.com.br/v1/domains \  -H "Authorization: Bearer $JETSEND_KEY" \  -H "Content-Type: application/json" \  -d '{"domain": "suaempresa.com.br"}'# Resposta inclui dnsRecords (DKIM, SPF, DMARC), publique todos no DNS.# 2) Após publicar, forçar verificação:curl -X POST https://api.jetsend.com.br/v1/domains/<DOMAIN_ID>/verify \  -H "Authorization: Bearer $JETSEND_KEY"

A resposta traz os registros de DNS (CNAME de DKIM e TXT de SPF) que você precisa publicar no provedor do domínio. Depois de publicar, chame POST /v1/domains/{id}/verify para forçar a verificação. O passo a passo, com as pegadinhas de provedor brasileiro, está em Verificar domínio.

Em outra linguagem

Node.js, Python, PHP.