Pular para o conteúdo
Docs

Eventos de e-mail

O ciclo de vida de cada e-mail enviado e recebido, da aceitação à entrega, aberturas, cliques e descadastros.

email.accepted

Enviado quando Enviar um e-mail ou Encaminhar um e-mail aceita um e-mail para entrega imediata. O Emailit envia um evento por destinatário, porque cada destinatário recebe o próprio ID de e-mail. Os e-mails enviados por SMTP e os e-mails criados com Tentar enviar um e-mail de novo não enviam este evento.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.accepted.

objectobject

O e-mail que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring

ID do e-mail (em_…).

objectstring

Sempre email.

fromstring

Remetente como informado na requisição. Pode incluir um nome de exibição, por exemplo Acme <hello@acme.com>.

tostring

Endereço do destinatário. O Emailit cria um e-mail separado, com o próprio ID, para cada destinatário.

subjectstring

Linha de assunto.

metaobject | null

O objeto meta que você enviou com o e-mail, ou null.

timestampstring

Quando o e-mail foi aceito, em ISO 8601 com deslocamento UTC.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.accepted",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "meta": {
      "order_id": "1042"
    },
    "timestamp": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "Acme <hello@acme.com>",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "meta": {
        "order_id": "1042"
      },
      "timestamp": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.scheduled

Enviado quando Enviar um e-mail aceita um e-mail com scheduled_at no futuro. O Emailit envia um evento por destinatário. Quando chega o horário agendado, o Emailit envia o e-mail sem um evento email.accepted; o próximo evento é um evento de entrega, como email.delivered.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.scheduled.

objectobject

O e-mail que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring

ID do e-mail (em_…).

objectstring

Sempre email.

fromstring

Remetente como informado na requisição. Pode incluir um nome de exibição, por exemplo Acme <hello@acme.com>.

tostring

Endereço do destinatário. O Emailit cria um e-mail separado, com o próprio ID, para cada destinatário.

subjectstring

Linha de assunto.

metaobject | null

O objeto meta que você enviou com o e-mail, ou null.

scheduled_atstring

Quando o Emailit vai enviar o e-mail.

timestampstring

Quando o e-mail foi aceito, em ISO 8601 com deslocamento UTC.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.scheduled",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your October invoice",
    "meta": {
      "invoice_id": "INV-2026-0142"
    },
    "scheduled_at": "2026-10-02T09:00:00.000000+00:00",
    "timestamp": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "Acme <hello@acme.com>",
      "to": "ada@example.com",
      "subject": "Your October invoice",
      "meta": {
        "invoice_id": "INV-2026-0142"
      },
      "scheduled_at": "2026-10-02T09:00:00.000000+00:00",
      "timestamp": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.delivered

Enviado quando o servidor de e-mail do destinatário aceita o e-mail. Entregue significa que o servidor de destino assumiu a responsabilidade pela mensagem; ele ainda pode filtrá-la para uma pasta de spam. Status de e-mail explica cada status.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.delivered.

objectobject

O e-mail que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring

ID do e-mail (em_…).

objectstring

Sempre email.

fromstring

Endereço do remetente, sem o nome de exibição.

tostring

Endereço do destinatário. O Emailit cria um e-mail separado para cada destinatário.

subjectstring | null

Linha de assunto.

statusstring

Sempre delivered.

metaobject | null

O objeto meta enviado com o e-mail, ou null.

updated_atstring

Quando o registro do e-mail foi atualizado pela última vez antes deste evento, em ISO 8601 com deslocamento UTC. Pode ser anterior à própria mudança de status.

created_atstring

Quando o Emailit aceitou o e-mail.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.delivered",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "delivered",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "delivered",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.attempted

Enviado sempre que uma tentativa de entrega falha com um erro temporário, como greylisting ou uma limitação de ritmo no servidor de destino, e o Emailit vai tentar de novo. O Emailit continua tentando, com intervalos cada vez maiores, por cerca de 21 horas; se a entrega ainda falhar, o e-mail dá bounce e você recebe email.bounced.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.attempted.

objectobject

O e-mail que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring

ID do e-mail (em_…).

objectstring

Sempre email.

fromstring

Endereço do remetente, sem o nome de exibição.

tostring

Endereço do destinatário. O Emailit cria um e-mail separado para cada destinatário.

subjectstring | null

Linha de assunto.

statusstring

Sempre attempted.

metaobject | null

O objeto meta enviado com o e-mail, ou null.

updated_atstring

Quando o registro do e-mail foi atualizado pela última vez antes deste evento, em ISO 8601 com deslocamento UTC. Pode ser anterior à própria mudança de status.

created_atstring

Quando o Emailit aceitou o e-mail.

smtp_codeinteger | null

Código de resposta SMTP do servidor de destino, por exemplo 421. null quando o próprio Emailit adiou a tentativa, por exemplo durante um backoff de entrega para esse servidor.

smtp_enhanced_codestring | null

Código de status estendido da resposta, por exemplo 4.7.0. Consulte Códigos de status estendidos.

smtp_responsestring | null

Resposta completa do servidor de destino.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.attempted",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "attempted",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00",
    "smtp_code": 421,
    "smtp_enhanced_code": "4.7.0",
    "smtp_response": "421 4.7.0 Try again later, closing connection."
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "attempted",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "smtp_code": 421,
      "smtp_enhanced_code": "4.7.0",
      "smtp_response": "421 4.7.0 Try again later, closing connection."
    }
  }
}

email.bounced

Enviado quando um e-mail não pode ser entregue: o servidor de destino o rejeitou com um erro permanente, uma notificação de bounce chegou após a entrega, todas as novas tentativas falharam ou o Emailit não conseguiu enviá-lo, por exemplo porque o domínio de envio dele foi excluído. Dependendo das suas configurações de supressão automática, o Emailit também suprime o endereço. Consulte Bounces e reclamações.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.bounced.

objectobject

O e-mail que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring

ID do e-mail (em_…).

objectstring

Sempre email.

fromstring

Endereço do remetente, sem o nome de exibição.

tostring

Endereço do destinatário. O Emailit cria um e-mail separado para cada destinatário.

subjectstring | null

Linha de assunto.

statusstring

Sempre bounced.

metaobject | null

O objeto meta enviado com o e-mail, ou null.

updated_atstring

Quando o registro do e-mail foi atualizado pela última vez antes deste evento, em ISO 8601 com deslocamento UTC. Pode ser anterior à própria mudança de status.

created_atstring

Quando o Emailit aceitou o e-mail.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.bounced",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "bounced",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "bounced",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.failed

Enviado quando o Emailit não consegue processar uma notificação de bounce que chegou ao endereço de return path do seu workspace, por exemplo por causa de um erro interno. O objeto descreve a mensagem de bounce, não o e-mail que você enviou. Este evento é raro: entregas com falha enviam email.bounced ou email.attempted.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.failed.

objectobject

A mensagem de bounce que o evento descreve. Os campos dela estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring

ID de e-mail (em_…) da mensagem de bounce.

objectstring

Sempre email.

fromstring

Remetente da mensagem de bounce, normalmente o mailer daemon do servidor de destino.

tostring

O endereço de return path do seu workspace no subdomínio emailit. do seu domínio de envio.

subjectstring | null

Assunto da mensagem de bounce.

statusstring

Sempre failed.

metaobject | null

Sempre null para mensagens de bounce.

updated_atstring

Quando a mensagem de bounce foi atualizada pela última vez antes deste evento, em ISO 8601 com deslocamento UTC.

created_atstring

Quando o Emailit recebeu a mensagem de bounce.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.failed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "mailer-daemon@mx1.example.com",
    "to": "2xKw0aNf5Zs8Yt1Lq4Ve7Mc3Pb6@emailit.acme.com",
    "subject": "Undelivered Mail Returned to Sender",
    "status": "failed",
    "meta": null,
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "mailer-daemon@mx1.example.com",
      "to": "2xKw0aNf5Zs8Yt1Lq4Ve7Mc3Pb6@emailit.acme.com",
      "subject": "Undelivered Mail Returned to Sender",
      "status": "failed",
      "meta": null,
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.rejected

Enviado quando o Emailit se recusa a enviar um e-mail porque o seu workspace ainda não tem acesso de produção e o destinatário não é membro do workspace. Até o workspace ser aprovado, você só pode enviar para os endereços das contas dos membros do workspace.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.rejected.

objectobject

O e-mail que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring

ID do e-mail (em_…).

objectstring

Sempre email.

fromstring

Endereço do remetente, sem o nome de exibição.

tostring

Endereço do destinatário. O Emailit cria um e-mail separado para cada destinatário.

subjectstring | null

Linha de assunto.

statusstring

Sempre rejected.

metaobject | null

O objeto meta enviado com o e-mail, ou null.

updated_atstring

Quando o registro do e-mail foi atualizado pela última vez antes deste evento, em ISO 8601 com deslocamento UTC. Pode ser anterior à própria mudança de status.

created_atstring

Quando o Emailit aceitou o e-mail.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.rejected",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "rejected",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "rejected",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.suppressed

Enviado quando o Emailit não envia um e-mail porque o destinatário tem uma supressão recipient na sua lista de supressão. Para voltar a enviar e-mails para o endereço, remova-o com Excluir uma supressão.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.suppressed.

objectobject

O e-mail que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring

ID do e-mail (em_…).

objectstring

Sempre email.

fromstring

Endereço do remetente, sem o nome de exibição.

tostring

Endereço do destinatário. O Emailit cria um e-mail separado para cada destinatário.

subjectstring | null

Linha de assunto.

statusstring

Sempre suppressed.

metaobject | null

O objeto meta enviado com o e-mail, ou null.

updated_atstring

Quando o registro do e-mail foi atualizado pela última vez antes deste evento, em ISO 8601 com deslocamento UTC. Pode ser anterior à própria mudança de status.

created_atstring

Quando o Emailit aceitou o e-mail.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.suppressed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "suppressed",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "suppressed",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.held

Enviado quando o Emailit retém um e-mail em vez de enviá-lo. Isso acontece quando o workspace está suspenso, o domínio de envio está pausado, a chave de API está configurada para reter mensagens, o workspace está sem créditos ou a pontuação da verificação de spam está igual ou acima do limite (7 por padrão). Depois de corrigir a causa, envie o e-mail de novo com Tentar enviar um e-mail de novo.

email.held não está na lista de eventos do painel. Você o recebe nos webhooks que têm all_events ativado ou adicionando-o a events com Atualizar um webhook.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.held.

objectobject

O e-mail que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring

ID do e-mail (em_…).

objectstring

Sempre email.

fromstring

Endereço do remetente, sem o nome de exibição.

tostring

Endereço do destinatário. O Emailit cria um e-mail separado para cada destinatário.

subjectstring | null

Linha de assunto.

statusstring

Sempre held.

metaobject | null

O objeto meta enviado com o e-mail, ou null.

updated_atstring

Quando o registro do e-mail foi atualizado pela última vez antes deste evento, em ISO 8601 com deslocamento UTC. Pode ser anterior à própria mudança de status.

created_atstring

Quando o Emailit aceitou o e-mail.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.held",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "held",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "held",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.canceled

Enviado quando você cancela um e-mail com Cancelar um e-mail. Se uma tentativa de entrega já estava em andamento, ela ainda pode ser concluída, então um evento de entrega pode vir em seguida.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.canceled.

objectobject

O e-mail que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring

ID do e-mail (em_…).

objectstring

Sempre email.

fromstring

Remetente como está armazenado no e-mail. Pode incluir um nome de exibição.

tostring

Endereço do destinatário.

subjectstring

Linha de assunto.

statusstring

Sempre canceled.

previous_statusstring

Status antes do cancelamento: scheduled, accepted ou attempted.

metaobject | null

O objeto meta enviado com o e-mail, ou null.

timestampstring

Quando o e-mail foi cancelado, em ISO 8601 com deslocamento UTC.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.canceled",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your October invoice",
    "status": "canceled",
    "previous_status": "scheduled",
    "meta": {
      "invoice_id": "INV-2026-0142"
    },
    "timestamp": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "Acme <hello@acme.com>",
      "to": "ada@example.com",
      "subject": "Your October invoice",
      "status": "canceled",
      "previous_status": "scheduled",
      "meta": {
        "invoice_id": "INV-2026-0142"
      },
      "timestamp": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.complained

Enviado quando um destinatário marca o seu e-mail como spam e o provedor de e-mail dele informa isso ao Emailit por um feedback loop. Dependendo das suas configurações de supressão automática, o Emailit adiciona uma supressão complaint para o endereço. Consulte Bounces e reclamações.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.complained.

objectobject

O e-mail que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring

ID do e-mail (em_…).

objectstring

Sempre email.

fromstring

Endereço do remetente, sem o nome de exibição.

tostring

Endereço do destinatário. O Emailit cria um e-mail separado para cada destinatário.

subjectstring | null

Linha de assunto.

statusstring

Sempre complained.

metaobject | null

O objeto meta enviado com o e-mail, ou null.

updated_atstring

Quando o registro do e-mail foi atualizado pela última vez antes deste evento, em ISO 8601 com deslocamento UTC. Pode ser anterior à própria mudança de status.

created_atstring

Quando o Emailit aceitou o e-mail.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.complained",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "complained",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "complained",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.received

Enviado quando o Emailit recebe um e-mail em um dos seus endereços de recebimento. O payload traz apenas o envelope: busque o corpo e os anexos com Obter um e-mail usando o id.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.received.

objectobject

O e-mail recebido que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring

ID de e-mail (em_…) do e-mail recebido.

objectstring

Sempre email.

fromstring

Endereço do remetente, tirado do cabeçalho From.

tostring

Endereço de recebimento que recebeu o e-mail.

subjectstring | null

Linha de assunto.

created_atstring

Quando o Emailit recebeu o e-mail, em ISO 8601 com deslocamento UTC.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.received",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "ada@example.com",
    "to": "support@inbound.acme.com",
    "subject": "Question about my order",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "ada@example.com",
      "to": "support@inbound.acme.com",
      "subject": "Question about my order",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.loaded

Enviado sempre que o pixel de rastreamento de um e-mail é carregado, o que normalmente significa que o destinatário o abriu. O rastreamento de aberturas exige um domínio de rastreamento verificado e o rastreamento de aberturas ativado no e-mail. Clientes de e-mail que pré-carregam ou bloqueiam imagens tornam as aberturas aproximadas.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.loaded.

objectobject

A abertura que o evento descreve. Os campos dela estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de carregamento

idstring

ID da abertura (load_…).

objectstring

Sempre load.

email_idstring

ID do e-mail (em_…).

emailobject

O e-mail.

email.idstring

ID do e-mail (em_…).

email.rcpt_tostring

Endereço do destinatário.

email.mail_fromstring

Remetente como está armazenado no e-mail. Pode incluir um nome de exibição.

email.subjectstring | null

Linha de assunto.

email.created_atstring

Quando o Emailit aceitou o e-mail.

email.campaignobject | null

id e name da campanha que enviou o e-mail, ou null para e-mails enviados pela API ou por SMTP.

email.metaobject | null

O objeto meta enviado com o e-mail, ou null.

contactobject | null

id e email do contato que tem o endereço do destinatário neste workspace, ou null se não houver nenhum.

ip_addressstring

Endereço IP da requisição.

user_agentstring | null

User agent do cliente que fez a requisição.

created_atstring

Quando o pixel foi carregado, em ISO 8601 com deslocamento UTC.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.loaded",
  "object": {
    "id": "load_2xLg2Cw7Sr4Xo9Ud1Zn6Ke3Lt8g",
    "object": "load",
    "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "email": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "rcpt_to": "ada@example.com",
      "mail_from": "Acme <news@acme.com>",
      "subject": "What's new in October",
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "meta": null
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "ip_address": "203.0.113.42",
    "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
    "created_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "load_2xLg2Cw7Sr4Xo9Ud1Zn6Ke3Lt8g",
      "object": "load",
      "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "email": {
        "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
        "rcpt_to": "ada@example.com",
        "mail_from": "Acme <news@acme.com>",
        "subject": "What's new in October",
        "created_at": "2026-10-01T10:02:11.583000+00:00",
        "campaign": {
          "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
          "name": "October product update"
        },
        "meta": null
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
      "created_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.clicked

Enviado sempre que alguém clica em um link rastreado de um e-mail. O rastreamento de cliques exige um domínio de rastreamento verificado e o rastreamento de cliques ativado no e-mail. O Emailit não filtra cliques automáticos, como as verificações de links feitas por scanners de segurança.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.clicked.

objectobject

O clique que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de clique

idstring

ID do clique (click_…).

objectstring

Sempre click.

email_idstring

ID do e-mail (em_…).

emailobject

O e-mail.

email.idstring

ID do e-mail (em_…).

email.rcpt_tostring

Endereço do destinatário.

email.mail_fromstring

Remetente como está armazenado no e-mail. Pode incluir um nome de exibição.

email.subjectstring | null

Linha de assunto.

email.created_atstring

Quando o Emailit aceitou o e-mail.

email.campaignobject | null

id e name da campanha que enviou o e-mail, ou null para e-mails enviados pela API ou por SMTP.

email.metaobject | null

O objeto meta enviado com o e-mail, ou null.

linkobject

O link que foi clicado.

link.idstring

ID do link (link_…).

link.urlstring

URL de destino.

contactobject | null

id e email do contato que tem o endereço do destinatário neste workspace, ou null se não houver nenhum.

ip_addressstring

Endereço IP da requisição.

user_agentstring | null

User agent do cliente que fez a requisição.

created_atstring

Quando o clique aconteceu, em ISO 8601 com deslocamento UTC.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.clicked",
  "object": {
    "id": "click_2xLg1Bv6Rq3Wn8Tc0Ym5Jd2Ks7f",
    "object": "click",
    "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "email": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "rcpt_to": "ada@example.com",
      "mail_from": "Acme <news@acme.com>",
      "subject": "What's new in October",
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "meta": null
    },
    "link": {
      "id": "link_2xLf9Pa4Vt1Qm6Xs3Hc8Nb0Rd5e",
      "url": "https://acme.com/blog/october-update"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "ip_address": "203.0.113.42",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15",
    "created_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "click_2xLg1Bv6Rq3Wn8Tc0Ym5Jd2Ks7f",
      "object": "click",
      "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "email": {
        "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
        "rcpt_to": "ada@example.com",
        "mail_from": "Acme <news@acme.com>",
        "subject": "What's new in October",
        "created_at": "2026-10-01T10:02:11.583000+00:00",
        "campaign": {
          "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
          "name": "October product update"
        },
        "meta": null
      },
      "link": {
        "id": "link_2xLf9Pa4Vt1Qm6Xs3Hc8Nb0Rd5e",
        "url": "https://acme.com/blog/october-update"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15",
      "created_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.unsubscribed

Enviado quando um contato se descadastra das suas campanhas, por exemplo pelo link de descadastro de um e-mail de campanha. O Emailit também envia subscriber.updated para cada lista de contatos que o contato deixou. Consulte Descadastros.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.unsubscribed.

objectobject

O e-mail de campanha que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring | null

ID (em_…) do e-mail de campanha em que o contato agiu, ou null se o Emailit não conseguiu associar nenhum.

objectstring

Sempre email.

fromstring

Remetente do e-mail de campanha.

tostring

O endereço do contato.

subjectstring

Assunto do e-mail de campanha.

campaignobject | null

id e name da campanha, ou null.

contactobject | null

id e email do contato.

unsubscribed_atstring

Quando o contato se descadastrou, em ISO 8601 com deslocamento UTC.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.unsubscribed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "news@acme.com",
    "to": "ada@example.com",
    "subject": "What's new in October",
    "campaign": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "name": "October product update"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "unsubscribed_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "news@acme.com",
      "to": "ada@example.com",
      "subject": "What's new in October",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "unsubscribed_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.resubscribed

Enviado quando um contato que se descadastrou das suas campanhas é inscrito de novo, por exemplo pela opção de reinscrição na página de descadastro. O Emailit também envia subscriber.updated para cada lista de contatos à qual o contato voltou.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre email.resubscribed.

objectobject

O e-mail de campanha que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de e-mail

idstring | null

ID (em_…) do e-mail de campanha em que o contato agiu, ou null se o Emailit não conseguiu associar nenhum.

objectstring

Sempre email.

fromstring

Remetente do e-mail de campanha.

tostring

O endereço do contato.

subjectstring

Assunto do e-mail de campanha.

campaignobject | null

id e name da campanha, ou null.

contactobject | null

id e email do contato.

resubscribed_atstring

Quando o contato se reinscreveu, em ISO 8601 com deslocamento UTC.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.resubscribed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "news@acme.com",
    "to": "ada@example.com",
    "subject": "What's new in October",
    "campaign": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "name": "October product update"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "resubscribed_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "news@acme.com",
      "to": "ada@example.com",
      "subject": "What's new in October",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "resubscribed_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.

Esc

Populares

↑↓para navegar↵para abrirEscpara fechar