Enviar emails em lote
Envie o mesmo email para vários destinatários em uma única chamada à API passando um array no campo to. Até 50 endereços por chamada. Cada destinatário recebe um email individual, e os endereços não ficam visíveis entre si.
https://mail.sendcorex.com/v3.0/sendO campo recipients na resposta confirma quantos endereços foram aceitos. Endereços inválidos no array são ignorados e informados em skipped.
Parâmetros do body
tostring[]obrigatórioArray de endereços de email dos destinatários. Máximo de 50 por chamada.
ex.
["alice@x.com", "bob@x.com", "carol@x.com"]
Todos os outros parâmetros são idênticos aos de Enviar email.
Início rápido
import axios from 'axios';
const response = await axios.post(
'https://mail.sendcorex.com/v3.0/send',
{
to: [
'alice@example.com',
'bob@example.com',
'carol@example.com',
],
from: 'noreply@yourdomain.com',
senderName: 'My App',
subject: 'Important update for all users',
body: '<p>Here is your update...</p>',
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);
const { id, ids, recipients, skipped } = response.data;
console.log('Sent to ' + recipients + ' recipients');
// Invalid addresses are skipped and reported in "skipped"
if (skipped) console.log('Skipped:', skipped);Resposta
{
"success": true,
"message": "Email queued successfully",
"code": "EMAIL_QUEUED_SUCCESS",
"id": "a898cf59-4b4e-4547-ad60-c0f818dae7fd",
"ids": [
{ "id": "a898cf59-4b4e-4547-ad60-c0f818dae7fd", "recipient": "foo@x.com" },
{ "id": "76627061-ab16-4bba-bcfc-ca7ff92ac251", "recipient": "bar@x.com" }
],
"recipients": 2,
"scheduledAt": null
}Os erros retornam um objeto JSON com error e code.
- 401
MISSING_AUTH_HEADERNenhum header Authorization presente.
- 401
INVALID_API_KEYA API key é inválida ou foi revogada.
- 401
ACCOUNT_BLOCKEDA conta foi bloqueada.
- 401
NO_CREDITS_LEFTCréditos de email insuficientes para todos os destinatários. Cada endereço em to, cc e bcc usa 1 crédito.
- 401
DOMAIN_NOT_VALIDATEDDomínio do remetente não verificado.
- 401
LISTED_SPAM_HAUSO domínio do remetente está listado no Spamhaus.
- 401
ISP_DOMAIN_BLOCKEDNão é permitido enviar de domínios conhecidos (gmail.com, outlook.com etc).
- 401
FROM_HEADER_DOMAIN_MISMATCHDomínio do header From não autorizado para este remetente.
- 401
USER_NOT_FOUNDUsuário não encontrado.
- 401
MISSING_USER_PRIVILEGESFaltam privilégios de usuário.
- 401
EMAIL_CREDITS_NOT_FOUNDErro ao buscar os créditos de email.
- 401
EMAIL_NOT_VALIDATEDO email da conta ainda não foi verificado.
- 429
CREDENTIAL_TEMPORARILY_BLOCKEDAPI key bloqueada temporariamente por violações repetidas da política.
- 429
IP_TEMPORARILY_BLOCKEDIP da requisição bloqueado temporariamente por violações repetidas da política.
- 429
TOO_MANY_CONCURRENT_CONNECTIONSRequisições simultâneas demais deste IP. Tente de novo em instantes.
- 400
INVALID_JSONO corpo da requisição não é um JSON válido.
- 400
MISSING_FROMO campo from está ausente ou vazio.
- 400
INVALID_FROM_FORMATO campo from precisa ser um endereço de email válido.
- 400
MISSING_SENDERNAMEO campo senderName está ausente ou vazio.
- 400
INVALID_SENDERNAME_FORMATO campo senderName contém caracteres inválidos.
- 400
MISSING_SUBJECTO campo subject está ausente ou vazio.
- 400
MISSING_BODYO campo body está ausente ou vazio.
- 400
MISSING_TOADDRESSO campo to está ausente ou vazio.
- 400
MISSING_TOO campo to está ausente ou vazio.
- 400
INVALID_TOADDRESSUm ou mais endereços de destinatário estão malformados.
- 400
TOADDRESS_LIMIT_EXCEEDEDMais de 50 destinatários no array to.
- 400
INVALID_CCADDRESSUm ou mais endereços de cc estão malformados.
- 400
INVALID_BCCADDRESSUm ou mais endereços de bcc estão malformados.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc e bcc juntos têm mais de 50 destinatários únicos.
- 400
INVALID_SCHEDULED_ATscheduled_at não é uma data válida ou está no passado.
- 400
INVALID_SENDER_FORMATO formato do email do remetente é inválido.
- 400
HEADER_NOT_ALLOWEDA chave do header personalizado não está na lista permitida (List-Unsubscribe, List-Id, X-* etc).
- 400
INVALID_HEADER_VALUEO valor do header contém caracteres inválidos (CR/LF não são permitidos).
- 400
DANGEROUS_ATTACHMENTUm ou mais anexos foram bloqueados por motivos de segurança.
- 400
INVALID_ATTACHMENTO conteúdo de um anexo não é base64 válido.
- 400
MISSING_UNSUBSCRIBE_PLACEHOLDERunsubscribe é true, mas o body não tem placeholder de descadastro ([unsubscribe_url], [unsubscribe], [unsub_url] ou [opt_out_url]).
- 403
ACCOUNT_RESTRICTEDA conta está restrita temporariamente.
- 403
DAILY_LIMITLimite diário de envio de emails atingido.
- 403
MARKETING_LIMIT_REACHEDLimite diário de marketing do plano free atingido: 30 emails de marketing ou cold outreach por dia, contados por destinatário numa janela móvel de 24 horas. A resposta traz limit, used, recipients e upgradeUrl. Emails transacionais continuam saindo; nada fica na fila.
- 403
FORBIDDEN_HTML_CONTENTO HTML contém conteúdo ativo não permitido em emails (script, iframe, form, input, button, embed, object, svg, handlers on*, links javascript:, meta refresh…). A resposta lista o que foi encontrado. Use um <a> estilizado em vez de botões ou formulários.
- 403
SPAM_DETECTEDConteúdo do email marcado como spam. A resposta inclui o quarantine_id e as instruções de liberação.
- 403
SENDER_NAME_MISMATCHVários nomes de remetente detectados para o mesmo endereço.
- 403
FOLLOWUP_PATTERN_DETECTEDConteúdo do email marcado como padrão repetido de follow-up suspeito.
- 403
SCAM_PATTERN_DETECTEDConteúdo do email marcado como padrão de golpe.
- 403
ACCOUNT_SUSPENDED_SPOOFINGConta suspensa por tentativas repetidas de falsificação do header From.
- 409
IDEMPOTENCY_IN_PROGRESSUma requisição com a mesma Idempotency-Key ainda está sendo processada. Espere (Retry-After: 1) e repita com a mesma chave.
- 422
IDEMPOTENCY_KEY_REUSEDEsta Idempotency-Key já foi usada com outro corpo. Use uma chave nova para cada email novo.
- 500
INTERNAL_SERVER_ERRORErro inesperado no servidor. Tente de novo.
- 500
PARSE_ERRORFalha ao processar o conteúdo do email (falha no parse MIME).
- 500
PERSIST_FAILEDFalha ao enfileirar o email (falha ao gravar no banco de dados).
- 503
AUTH_UNAVAILABLENão foi possível validar a API key agora. Tente de novo.
- 503
UNSUBSCRIBE_UNAVAILABLEServiço de link de descadastro temporariamente indisponível. Tente mais tarde.