# Eventos de domínio

> Domínios de envio criados, atualizados ou excluídos.



## domain.created

> Enviado quando um domínio de envio é adicionado ao workspace. Inclui os registros DNS a publicar, todos com o status pending.

# domain.created

Enviado quando um domínio de envio é adicionado ao workspace, por exemplo com [Criar um domínio](/pt/docs/api-reference/domains/create/). O payload inclui os registros DNS a publicar; todos começam como `pending`. Consulte [Adicionar um domínio](/pt/docs/domains/add-a-domain/).

As requisições de webhook trazem um array JSON de eventos como este; consulte [Requisições de webhook](/pt/docs/webhooks/webhook-requests/).

```json
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "domain.created",
  "object": {
    "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
    "object": "domain",
    "name": "acme.com",
    "tracking_key": null,
    "inbound_key": null,
    "track_loads": false,
    "track_clicks": false,
    "created_at": "2026-10-01T10:02:11.583000+00:00",
    "dns_records": [
      {
        "required": true,
        "type": "MX",
        "name": "emailit.acme.com",
        "value": "feedback-smtp.ffdc-1.emailit.com",
        "priority": 10,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit.acme.com",
        "value": "v=spf1 include:_spf.emailit.com ~all",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit._domainkey.acme.com",
        "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "TXT",
        "name": "_dmarc.acme.com",
        "value": "v=DMARC1; p=none;",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "CNAME",
        "name": "go.acme.com",
        "value": "go.emailitmail.com",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "MX",
        "name": "inbound.acme.com",
        "value": "inbound.emailitmail.com",
        "priority": 10,
        "ttl": "auto",
        "status": "pending",
        "error": null
      }
    ]
  },
  "data": {
    "object": {
      "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
      "object": "domain",
      "name": "acme.com",
      "tracking_key": null,
      "inbound_key": null,
      "track_loads": false,
      "track_clicks": false,
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "dns_records": [
        {
          "required": true,
          "type": "MX",
          "name": "emailit.acme.com",
          "value": "feedback-smtp.ffdc-1.emailit.com",
          "priority": 10,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit.acme.com",
          "value": "v=spf1 include:_spf.emailit.com ~all",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit._domainkey.acme.com",
          "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "TXT",
          "name": "_dmarc.acme.com",
          "value": "v=DMARC1; p=none;",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "CNAME",
          "name": "go.acme.com",
          "value": "go.emailitmail.com",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "MX",
          "name": "inbound.acme.com",
          "value": "inbound.emailitmail.com",
          "priority": 10,
          "ttl": "auto",
          "status": "pending",
          "error": null
        }
      ]
    }
  }
}
```

## Campos

- `event_id` (string): 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](/pt/docs/api-reference/events/get/).

- `type` (string): Sempre `domain.created`.

- `object` (object): O domínio que o evento descreve. Os campos dele estão listados abaixo.

- `data.object` (object): O mesmo objeto de novo, no formato que a [API de eventos](/pt/docs/api-reference/events/get/) retorna em `data`.

### Objeto de domínio

- `id` (string): ID do domínio (`dom_…`).

- `object` (string): Sempre `domain`.

- `name` (string): Nome do domínio, por exemplo `acme.com`.

- `tracking_key` (string | null): Subdomínio personalizado para o CNAME de rastreamento, ou `null` para o padrão `go`.

- `inbound_key` (string | null): Subdomínio personalizado para o registro MX de recebimento, ou `null` para o padrão `inbound`.

- `track_loads` (boolean): Se o rastreamento de aberturas está ativado por padrão para os e-mails deste domínio.

- `track_clicks` (boolean): Se o rastreamento de cliques está ativado por padrão para os e-mails deste domínio.

- `created_at` (string): Quando o domínio foi adicionado, em ISO 8601 com deslocamento UTC.

- `dns_records` (object[]): Registros DNS do domínio. Consulte [Registros DNS](/pt/docs/domains/dns-records/).

- `dns_records[].required` (boolean): `true` para os registros MX de return path, SPF e DKIM, que são necessários para a verificação. Os registros de DMARC, de rastreamento e de recebimento são opcionais.

- `dns_records[].type` (string): `MX`, `TXT` ou `CNAME`.

- `dns_records[].name` (string): Nome de host do registro.

- `dns_records[].value` (string): Valor a publicar.

- `dns_records[].priority` (integer | null): Prioridade do MX, ou `null` para os outros tipos.

- `dns_records[].ttl` (string): Sempre `auto`.

- `dns_records[].status` (string): Resultado da última verificação de DNS: `pending`, `ok`, `missing` ou `invalid`.

- `dns_records[].error` (string | null): Por que a última verificação falhou, ou `null`.

---
Fonte: https://emailit.com/pt/docs/webhooks/events/domain/domain-created/

## domain.updated

> Enviado quando as configurações de um domínio de envio mudam, como as opções de rastreamento ou de recebimento. As verificações não enviam este evento.

# domain.updated

Enviado quando as configurações de um domínio mudam, por exemplo as opções de rastreamento ou de recebimento, com [Atualizar um domínio](/pt/docs/api-reference/domains/update/) ou no painel. As verificações de DNS e a verificação do domínio não enviam este evento; use [Obter um domínio](/pt/docs/api-reference/domains/get/) para acompanhar o status da verificação.

As requisições de webhook trazem um array JSON de eventos como este; consulte [Requisições de webhook](/pt/docs/webhooks/webhook-requests/).

```json
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "domain.updated",
  "object": {
    "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
    "object": "domain",
    "name": "acme.com",
    "verified_at": "2026-09-28T08:40:19.226000+00:00",
    "tracking_key": null,
    "inbound_key": null,
    "track_loads": true,
    "track_clicks": true,
    "dns_checked_at": "2026-10-01T03:00:07.512000+00:00",
    "created_at": "2026-09-28T08:31:52.690000+00:00",
    "dns_records": [
      {
        "required": true,
        "type": "MX",
        "name": "emailit.acme.com",
        "value": "feedback-smtp.ffdc-1.emailit.com",
        "priority": 10,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit.acme.com",
        "value": "v=spf1 include:_spf.emailit.com ~all",
        "priority": null,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit._domainkey.acme.com",
        "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
        "priority": null,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": false,
        "type": "TXT",
        "name": "_dmarc.acme.com",
        "value": "v=DMARC1; p=none;",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "CNAME",
        "name": "go.acme.com",
        "value": "go.emailitmail.com",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "MX",
        "name": "inbound.acme.com",
        "value": "inbound.emailitmail.com",
        "priority": 10,
        "ttl": "auto",
        "status": "pending",
        "error": null
      }
    ]
  },
  "data": {
    "object": {
      "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
      "object": "domain",
      "name": "acme.com",
      "verified_at": "2026-09-28T08:40:19.226000+00:00",
      "tracking_key": null,
      "inbound_key": null,
      "track_loads": true,
      "track_clicks": true,
      "dns_checked_at": "2026-10-01T03:00:07.512000+00:00",
      "created_at": "2026-09-28T08:31:52.690000+00:00",
      "dns_records": [
        {
          "required": true,
          "type": "MX",
          "name": "emailit.acme.com",
          "value": "feedback-smtp.ffdc-1.emailit.com",
          "priority": 10,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit.acme.com",
          "value": "v=spf1 include:_spf.emailit.com ~all",
          "priority": null,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit._domainkey.acme.com",
          "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
          "priority": null,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": false,
          "type": "TXT",
          "name": "_dmarc.acme.com",
          "value": "v=DMARC1; p=none;",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "CNAME",
          "name": "go.acme.com",
          "value": "go.emailitmail.com",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "MX",
          "name": "inbound.acme.com",
          "value": "inbound.emailitmail.com",
          "priority": 10,
          "ttl": "auto",
          "status": "pending",
          "error": null
        }
      ]
    }
  }
}
```

## Campos

- `event_id` (string): 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](/pt/docs/api-reference/events/get/).

- `type` (string): Sempre `domain.updated`.

- `object` (object): O domínio que o evento descreve. Os campos dele estão listados abaixo.

- `data.object` (object): O mesmo objeto de novo, no formato que a [API de eventos](/pt/docs/api-reference/events/get/) retorna em `data`.

### Objeto de domínio

- `id` (string): ID do domínio (`dom_…`).

- `object` (string): Sempre `domain`.

- `name` (string): Nome do domínio, por exemplo `acme.com`.

- `verified_at` (string | null): Quando o domínio foi verificado, ou `null` se ele não estiver verificado.

- `tracking_key` (string | null): Subdomínio personalizado para o CNAME de rastreamento, ou `null` para o padrão `go`.

- `inbound_key` (string | null): Subdomínio personalizado para o registro MX de recebimento, ou `null` para o padrão `inbound`.

- `track_loads` (boolean): Se o rastreamento de aberturas está ativado por padrão para os e-mails deste domínio.

- `track_clicks` (boolean): Se o rastreamento de cliques está ativado por padrão para os e-mails deste domínio.

- `dns_checked_at` (string | null): Quando o Emailit verificou os registros DNS pela última vez.

- `created_at` (string): Quando o domínio foi adicionado, em ISO 8601 com deslocamento UTC.

- `dns_records` (object[]): Registros DNS do domínio. Consulte [Registros DNS](/pt/docs/domains/dns-records/).

- `dns_records[].required` (boolean): `true` para os registros MX de return path, SPF e DKIM, que são necessários para a verificação. Os registros de DMARC, de rastreamento e de recebimento são opcionais.

- `dns_records[].type` (string): `MX`, `TXT` ou `CNAME`.

- `dns_records[].name` (string): Nome de host do registro.

- `dns_records[].value` (string): Valor a publicar.

- `dns_records[].priority` (integer | null): Prioridade do MX, ou `null` para os outros tipos.

- `dns_records[].ttl` (string): Sempre `auto`.

- `dns_records[].status` (string): Resultado da última verificação de DNS: `pending`, `ok`, `missing` ou `invalid`.

- `dns_records[].error` (string | null): Por que a última verificação falhou, ou `null`.

---
Fonte: https://emailit.com/pt/docs/webhooks/events/domain/domain-updated/

## domain.deleted

> Enviado quando um domínio de envio é excluído do workspace. O payload é o domínio como ele era antes da exclusão.

# domain.deleted

Enviado quando um domínio de envio é excluído, por exemplo com [Excluir um domínio](/pt/docs/api-reference/domains/delete/). O payload é o domínio como ele era antes de ser excluído.

As requisições de webhook trazem um array JSON de eventos como este; consulte [Requisições de webhook](/pt/docs/webhooks/webhook-requests/).

```json
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "domain.deleted",
  "object": {
    "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
    "object": "domain",
    "name": "acme.com",
    "verified_at": "2026-09-28T08:40:19.226000+00:00",
    "tracking_key": null,
    "inbound_key": null,
    "track_loads": true,
    "track_clicks": true,
    "dns_checked_at": "2026-10-01T03:00:07.512000+00:00",
    "created_at": "2026-09-28T08:31:52.690000+00:00",
    "dns_records": [
      {
        "required": true,
        "type": "MX",
        "name": "emailit.acme.com",
        "value": "feedback-smtp.ffdc-1.emailit.com",
        "priority": 10,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit.acme.com",
        "value": "v=spf1 include:_spf.emailit.com ~all",
        "priority": null,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit._domainkey.acme.com",
        "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
        "priority": null,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": false,
        "type": "TXT",
        "name": "_dmarc.acme.com",
        "value": "v=DMARC1; p=none;",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "CNAME",
        "name": "go.acme.com",
        "value": "go.emailitmail.com",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "MX",
        "name": "inbound.acme.com",
        "value": "inbound.emailitmail.com",
        "priority": 10,
        "ttl": "auto",
        "status": "pending",
        "error": null
      }
    ]
  },
  "data": {
    "object": {
      "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
      "object": "domain",
      "name": "acme.com",
      "verified_at": "2026-09-28T08:40:19.226000+00:00",
      "tracking_key": null,
      "inbound_key": null,
      "track_loads": true,
      "track_clicks": true,
      "dns_checked_at": "2026-10-01T03:00:07.512000+00:00",
      "created_at": "2026-09-28T08:31:52.690000+00:00",
      "dns_records": [
        {
          "required": true,
          "type": "MX",
          "name": "emailit.acme.com",
          "value": "feedback-smtp.ffdc-1.emailit.com",
          "priority": 10,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit.acme.com",
          "value": "v=spf1 include:_spf.emailit.com ~all",
          "priority": null,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit._domainkey.acme.com",
          "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
          "priority": null,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": false,
          "type": "TXT",
          "name": "_dmarc.acme.com",
          "value": "v=DMARC1; p=none;",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "CNAME",
          "name": "go.acme.com",
          "value": "go.emailitmail.com",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "MX",
          "name": "inbound.acme.com",
          "value": "inbound.emailitmail.com",
          "priority": 10,
          "ttl": "auto",
          "status": "pending",
          "error": null
        }
      ]
    }
  }
}
```

## Campos

- `event_id` (string): 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](/pt/docs/api-reference/events/get/).

- `type` (string): Sempre `domain.deleted`.

- `object` (object): O domínio que o evento descreve. Os campos dele estão listados abaixo.

- `data.object` (object): O mesmo objeto de novo, no formato que a [API de eventos](/pt/docs/api-reference/events/get/) retorna em `data`.

### Objeto de domínio

- `id` (string): ID do domínio (`dom_…`).

- `object` (string): Sempre `domain`.

- `name` (string): Nome do domínio, por exemplo `acme.com`.

- `verified_at` (string | null): Quando o domínio foi verificado, ou `null` se ele não estiver verificado.

- `tracking_key` (string | null): Subdomínio personalizado para o CNAME de rastreamento, ou `null` para o padrão `go`.

- `inbound_key` (string | null): Subdomínio personalizado para o registro MX de recebimento, ou `null` para o padrão `inbound`.

- `track_loads` (boolean): Se o rastreamento de aberturas está ativado por padrão para os e-mails deste domínio.

- `track_clicks` (boolean): Se o rastreamento de cliques está ativado por padrão para os e-mails deste domínio.

- `dns_checked_at` (string | null): Quando o Emailit verificou os registros DNS pela última vez.

- `created_at` (string): Quando o domínio foi adicionado, em ISO 8601 com deslocamento UTC.

- `dns_records` (object[]): Registros DNS do domínio. Consulte [Registros DNS](/pt/docs/domains/dns-records/).

- `dns_records[].required` (boolean): `true` para os registros MX de return path, SPF e DKIM, que são necessários para a verificação. Os registros de DMARC, de rastreamento e de recebimento são opcionais.

- `dns_records[].type` (string): `MX`, `TXT` ou `CNAME`.

- `dns_records[].name` (string): Nome de host do registro.

- `dns_records[].value` (string): Valor a publicar.

- `dns_records[].priority` (integer | null): Prioridade do MX, ou `null` para os outros tipos.

- `dns_records[].ttl` (string): Sempre `auto`.

- `dns_records[].status` (string): Resultado da última verificação de DNS: `pending`, `ok`, `missing` ou `invalid`.

- `dns_records[].error` (string | null): Por que a última verificação falhou, ou `null`.

---
Fonte: https://emailit.com/pt/docs/webhooks/events/domain/domain-deleted/
