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
POSThttps://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. 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. 2

    Adicione o domínio

    Add Domain cria a chave DKIM e retorna os registros a publicar.

  3. 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
  }
}
validated

true quando os registros Return-Path e DKIM são encontrados. Só domínios validados podem ter senders.

dns_records

SPF, DKIM, MX, Return-Path e DMARC, cada um com type, host e value. Return-Path e DKIM são os obrigatórios.

registrar

Onde seu DNS está hospedado. Define se host é relativo (Cloudflare, Namecheap…) ou o nome completo (GoDaddy…).

dkim

A 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 DNS

Passe 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 Instructions

Faç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 funciona

Envie 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 Domains

Referência completa

Tudo marcado como CMD é um comando enviado por POST /v1/domain, até 10 por request.