Email

Enviar anexos

Anexe arquivos a qualquer email incluindo o array attachments no payload de envio. Os arquivos precisam estar em base64, e você pode incluir vários anexos em uma única chamada.

POSThttps://mail.sendcorex.com/v3.0/send
i

Os anexos usam o mesmo endpoint de Enviar email. Adicione o array attachments junto aos outros parâmetros do body.

Parâmetros do anexo

Cada item do array attachments é um objeto com os campos abaixo.

  • filenamestringobrigatório

    O nome do arquivo exibido ao destinatário no cliente de email.

    ex. "invoice.pdf"

  • contentstringobrigatório

    O conteúdo do arquivo codificado como string base64.

    ex. "JVBERi0xLjQKJeLjz9MK..."

  • encodingstringobrigatório

    A codificação de content. Precisa ser "base64".

    ex. "base64"

Início rápido

import axios from 'axios';
import fs from 'fs';

const fileContent = fs.readFileSync('./invoice.pdf').toString('base64');

try {
  const response = await axios.post(
    'https://mail.sendcorex.com/v3.0/send',
    {
      to: 'user@example.com',
      from: 'noreply@yourdomain.com',
      senderName: 'My App',
      subject: 'Your Invoice #1042',
      body: '<p>Please find your invoice attached.</p>',
      attachments: [
        {
          filename: 'invoice.pdf',
          content: fileContent,
          encoding: 'base64',
        },
      ],
    },
    { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
  );

  const { id, ids, recipients } = response.data;
  console.log('Queued:', id, '| recipients:', recipients);
} catch (err) {
  if (err.response?.status === 400 && err.response.data.code === 'DANGEROUS_ATTACHMENT') {
    // Attachment blocked for security reasons. There is no quarantine record.
    console.log('Blocked:', err.response.data.riskLevel);
  } else {
    throw err;
  }
}

Resposta

{
  "success": true,
  "message": "Email queued successfully",
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "ids": [
    { "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
  ],
  "recipients": 1,
  "scheduledAt": null
}

Meu anexo foi bloqueado

Para proteger nossa plataforma e a reputação de envio de todos os clientes, os anexos são verificados antes de o email entrar na fila. Quando um arquivo é considerado inseguro, a requisição retorna 400 com o código DANGEROUS_ATTACHMENT e o email não é enviado.

400

Anexo bloqueado

{
  "error": "One or more attachments were blocked for security reasons.",
  "code": "DANGEROUS_ATTACHMENT",
  "riskLevel": "high"
}
  • error

    Uma mensagem legível explicando que um anexo foi bloqueado.

  • code

    Sempre DANGEROUS_ATTACHMENT nesta resposta.

  • riskLevel

    O nível de risco atribuído ao anexo bloqueado. Inclua-o ao falar com o suporte.

!

Não há registro de quarentena para este erro.Ao contrário dos emails marcados como spam, um anexo bloqueado não pode ser liberado com /quarantine/release. É uma proteção proposital contra spammers e remetentes abusivos, então o email nunca fica retido para entrega posterior.

O que devo fazer?

As verificações automáticas podem, às vezes, marcar um arquivo legítimo. Se você precisa enviar esse anexo, fale com nosso suporte. Nossa equipe conhece esse comportamento e, quando um bloqueio se revela um falso positivo, analisamos e aplicamos as atualizações necessárias.

Para resolvermos mais rápido, inclua:

  • O nome e o tipo do arquivo anexado
  • O riskLevel retornado pela API
  • Para que o arquivo é usado no seu produto
Falar com o suporte →

Os erros retornam um objeto JSON com error e code.

  • 401MISSING_AUTH_HEADER

    Nenhum header Authorization presente.

  • 401INVALID_API_KEY

    A API key é inválida ou foi revogada.

  • 401ACCOUNT_BLOCKED

    A conta foi bloqueada.

  • 401NO_CREDITS_LEFT

    Créditos de email insuficientes para todos os destinatários. Cada endereço em to, cc e bcc usa 1 crédito.

  • 401DOMAIN_NOT_VALIDATED

    Domínio do remetente não verificado.

  • 401LISTED_SPAM_HAUS

    O domínio do remetente está listado no Spamhaus.

  • 401ISP_DOMAIN_BLOCKED

    Não é permitido enviar de domínios conhecidos (gmail.com, outlook.com etc).

  • 401FROM_HEADER_DOMAIN_MISMATCH

    Domínio do header From não autorizado para este remetente.

  • 401USER_NOT_FOUND

    Usuário não encontrado.

  • 401MISSING_USER_PRIVILEGES

    Faltam privilégios de usuário.

  • 401EMAIL_CREDITS_NOT_FOUND

    Erro ao buscar os créditos de email.

  • 401EMAIL_NOT_VALIDATED

    O email da conta ainda não foi verificado.

  • 429CREDENTIAL_TEMPORARILY_BLOCKED

    API key bloqueada temporariamente por violações repetidas da política.

  • 429IP_TEMPORARILY_BLOCKED

    IP da requisição bloqueado temporariamente por violações repetidas da política.

  • 429TOO_MANY_CONCURRENT_CONNECTIONS

    Requisições simultâneas demais deste IP. Tente de novo em instantes.

  • 400INVALID_JSON

    O corpo da requisição não é um JSON válido.

  • 400MISSING_FROM

    O campo from está ausente ou vazio.

  • 400INVALID_FROM_FORMAT

    O campo from precisa ser um endereço de email válido.

  • 400MISSING_SENDERNAME

    O campo senderName está ausente ou vazio.

  • 400INVALID_SENDERNAME_FORMAT

    O campo senderName contém caracteres inválidos.

  • 400MISSING_SUBJECT

    O campo subject está ausente ou vazio.

  • 400MISSING_BODY

    O campo body está ausente ou vazio.

  • 400MISSING_TOADDRESS

    O campo to está ausente ou vazio.

  • 400MISSING_TO

    O campo to está ausente ou vazio.

  • 400INVALID_TOADDRESS

    Um ou mais endereços de destinatário estão malformados.

  • 400TOADDRESS_LIMIT_EXCEEDED

    Mais de 50 destinatários no array to.

  • 400INVALID_CCADDRESS

    Um ou mais endereços de cc estão malformados.

  • 400INVALID_BCCADDRESS

    Um ou mais endereços de bcc estão malformados.

  • 400RECIPIENT_LIMIT_EXCEEDED

    to, cc e bcc juntos têm mais de 50 destinatários únicos.

  • 400INVALID_SCHEDULED_AT

    scheduled_at não é uma data válida ou está no passado.

  • 400INVALID_SENDER_FORMAT

    O formato do email do remetente é inválido.

  • 400HEADER_NOT_ALLOWED

    A chave do header personalizado não está na lista permitida (List-Unsubscribe, List-Id, X-* etc).

  • 400INVALID_HEADER_VALUE

    O valor do header contém caracteres inválidos (CR/LF não são permitidos).

  • 400DANGEROUS_ATTACHMENT

    Um ou mais anexos foram bloqueados por motivos de segurança.

  • 400INVALID_ATTACHMENT

    O conteúdo de um anexo não é base64 válido.

  • 400MISSING_UNSUBSCRIBE_PLACEHOLDER

    unsubscribe é true, mas o body não tem placeholder de descadastro ([unsubscribe_url], [unsubscribe], [unsub_url] ou [opt_out_url]).

  • 403ACCOUNT_RESTRICTED

    A conta está restrita temporariamente.

  • 403DAILY_LIMIT

    Limite diário de envio de emails atingido.

  • 403MARKETING_LIMIT_REACHED

    Limite 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.

  • 403FORBIDDEN_HTML_CONTENT

    O 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.

  • 403SPAM_DETECTED

    Conteúdo do email marcado como spam. A resposta inclui o quarantine_id e as instruções de liberação.

  • 403SENDER_NAME_MISMATCH

    Vários nomes de remetente detectados para o mesmo endereço.

  • 403FOLLOWUP_PATTERN_DETECTED

    Conteúdo do email marcado como padrão repetido de follow-up suspeito.

  • 403SCAM_PATTERN_DETECTED

    Conteúdo do email marcado como padrão de golpe.

  • 403ACCOUNT_SUSPENDED_SPOOFING

    Conta suspensa por tentativas repetidas de falsificação do header From.

  • 409IDEMPOTENCY_IN_PROGRESS

    Uma requisição com a mesma Idempotency-Key ainda está sendo processada. Espere (Retry-After: 1) e repita com a mesma chave.

  • 422IDEMPOTENCY_KEY_REUSED

    Esta Idempotency-Key já foi usada com outro corpo. Use uma chave nova para cada email novo.

  • 500INTERNAL_SERVER_ERROR

    Erro inesperado no servidor. Tente de novo.

  • 500PARSE_ERROR

    Falha ao processar o conteúdo do email (falha no parse MIME).

  • 500PERSIST_FAILED

    Falha ao enfileirar o email (falha ao gravar no banco de dados).

  • 503AUTH_UNAVAILABLE

    Não foi possível validar a API key agora. Tente de novo.

  • 503UNSUBSCRIBE_UNAVAILABLE

    Serviço de link de descadastro temporariamente indisponível. Tente mais tarde.