Domínios
Envie do seu próprio domínio, autenticado
Adicione um domínio, publique os registros que fornecemos e comece a enviar com DKIM, SPF, DMARC e Return-Path alinhados. Os registros já vêm formatados para o seu painel DNS.
- Comandos JSON
- DKIM 2048
- Troca de chave sem downtime
- Validação automática
- Hosts no formato do seu registrador
https://g.sendcorex.com/v1/domaindomain:*Como funciona
Registros prontos para colar
Detectamos onde seu DNS está hospedado e escrevemos cada host do jeito que aquele painel espera. Valores DKIM longos também vêm divididos para os painéis que precisam.
Validado sozinho
Todo Get Domain verifica o DNS em tempo real. No momento em que o Return-Path e o DKIM são encontrados, o domínio é validado e você recebe um email.
Chaves que envelhecem bem
Domínios novos recebem DKIM de 2048 bits. Chaves antigas de 1024 bits migram para 2048 em um novo seletor, com a antiga assinando até o novo registro estar no ar.
Primeiros passos
Só a chave é necessária antes do seu primeiro request.
- 1
Crie uma API key com scopes de domínio
No dashboard, abra Developers → API Keys e dê à chave domain:read e domain:create. Adicione domain:delete só se ela realmente precisar excluir.
O token do webmail não funciona aqui. Esta API usa a API key do dashboard.
- 2
Adicione o domínio
Add Domain cria a chave DKIM e retorna os registros a publicar.
- 3
Publique e verifique
Crie os registros no seu painel DNS e chame Get Domain até validated ser true. Depois disso, crie senders nele.
O domínio
Add Domain e Get Domain retornam o domínio neste formato.
{
"domain": "news.acme.com",
"validated": false,
"has_mx": false,
"has_spf": false,
"has_dkim": false,
"has_dmarc": false,
"has_return_path": false,
"description": null,
"dkim_key_size": 2048,
"dkim_deprecated": false,
"dkim_upgrade_pending": false,
"created_at": "2026-10-21T03:02:15.441Z",
"updated_at": "2026-10-21T03:02:15.441Z",
"registrar": "cloudflare",
"dns_records": {
"spf": {
"type": "TXT",
"host": "news.acme.com",
"value": "v=spf1 include:smtp.emailsbit.com ~all"
},
"dkim": {
"type": "TXT",
"host": "sendcorex._domainkey.news",
"value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu1SU1LfVLPHCozMxH2Mo4lgOEePzNm0tRgeLezV6ffAt0gunVTLw7onLRnrq0/IzW7yWR7QkrmBL7jTKEn5u+qKhbwKfBstIs+bMY2Zkp18gnTxKLxoS2tFczGkPLPgizskuemMghRniWaoLcyehkd3qqGElvW/VDL5AaWTg0nLVkjRo9z+40RQzuVaE8AkAFmxZzow3x+VJYKdjykkJ0iT9wCS0DRTXu269V264Vf/3jvredZiKRkgwlL9xNAwxXFg0x/XFw005UWVRIkdgcKWTjpBP2dPwVZ4WWC+9aGVd+Gyn1o0CLelf4rEjGoXbAAEgAqeGUxrcIlbjXfbcmwIDAQAB",
"split_value": "\"v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu1SU1LfVLPHCozMxH2Mo4lgOEePzNm0tRgeLezV6ffAt0gunVTLw7onLRnrq0/IzW7yWR7QkrmBL7jTKEn5u+qKhbwKfBstIs+bMY2Zkp18gnTxKLxoS2tFczGkPLPgizskuemMghRniWaoLcyehkd3qqGElvW/VDL5AaWTg0nLVkjRo9z+40RQzuVaE8AkAF\" \"mxZzow3x+VJYKdjykkJ0iT9wCS0DRTXu269V264Vf/3jvredZiKRkgwlL9xNAwxXFg0x/XFw005UWVRIkdgcKWTjpBP2dPwVZ4WWC+9aGVd+Gyn1o0CLelf4rEjGoXbAAEgAqeGUxrcIlbjXfbcmwIDAQAB\""
},
"mx": {
"type": "MX",
"host": "news.acme.com",
"value": "bounce.emailsbit.com",
"priority": 0
},
"return_path": {
"type": "CNAME",
"host": "bounces.news",
"value": "bounce.emailsbit.com"
},
"dmarc": {
"type": "TXT",
"host": "_dmarc.news",
"value": "v=DMARC1; p=none; rua=mailto:dmarc@bounces.news.acme.com"
}
},
"spf_duplicate": false,
"spf_duplicate_records": [],
"dkim": {
"version": 2,
"key_size": 2048,
"selector": "sendcorex",
"deprecated": false,
"upgrade_pending": false,
"pending": null,
"previous_selector": null,
"keep_old_record_until": null,
"just_upgraded": false
}
}validatedtrue quando os registros Return-Path e DKIM são encontrados. Só domínios validados podem ter senders.
dns_recordsSPF, DKIM, MX, Return-Path e DMARC, cada um com type, host e value. Return-Path e DKIM são os obrigatórios.
registrarOnde seu DNS está hospedado. Define se host é relativo (Cloudflare, Namecheap…) ou o nome completo (GoDaddy…).
dkimA chave em uso, seu tamanho e qualquer upgrade em andamento.
Seu primeiro request
Adicione um subdomínio para suas newsletters. Substitua SENDCOREX_API_KEY pela sua API key.
curl -X POST 'https://g.sendcorex.com/v1/domain' \
-H "Authorization: $SENDCOREX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "add_domain", "args": { "domain": "news.acme.com" } }
]
}'Você recebe os registros a publicar. Publique-os e chame get_domain com o mesmo domínio até validated ser true. O mesmo request em 8 linguagens está em Add Domain.
Tarefas comuns
Faça o onboarding de clientes dentro da sua aplicação
Adicione o domínio deles pela sua própria interface, mostre os registros e consulte Get Domain até ficar verde.
Aguardando o DNSPasse o DNS para outra pessoa
Envie por email os registros exatos para o time de TI ou a agência que gerencia o domínio.
Send DNS InstructionsFaça upgrade das chaves antigas de 1024 bits
Encontre domínios com dkim_deprecated e migre-os para 2048 bits sem um minuto de DKIM falhando.
Como o upgrade funcionaEnvie antes de o seu domínio estar pronto
Crie um sender em um domínio compartilhado que já verificamos e troque para o seu depois.
List Free DomainsReferência completa
Tudo marcado como CMD é um comando enviado por POST /v1/domain, até 10 por request.
Rotas
1Domínios
6- CMDList DomainsTodos os domínios e o que está verificado
- CMDGet DomainVerifica o DNS agora e retorna os registros
- CMDAdd DomainRegistra um domínio e cria sua chave DKIM
- CMDDelete DomainRemove um domínio e seus senders
- CMDUpdate Domain DescriptionSua própria nota sobre um domínio
- CMDList Free DomainsDomínios compartilhados prontos para usar