Pular para o conteúdo
Docs

Eventos de lista de verificação

Listas de verificação criadas e concluídas.

email_verification_list.created

Enviado quando você cria uma lista com Criar uma lista. A verificação já começou, então status é processing, e stats tem os valores iniciais.

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_verification_list.created.

objectobject

A lista de verificação 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 lista de verificação

idstring

ID da lista (evl_…).

objectstring

Sempre email_verification_list.

namestring

Nome da lista.

statusstring

processing em email_verification_list.created, completed em email_verification_list.updated.

statsobject

Contagens: total_emails, processed_emails, successful_verifications, failed_verifications e pending_emails, além de results com os endereços concluídos por resultado. Consulte Estatísticas.

created_atstring

Quando a lista foi criada, em ISO 8601 com deslocamento UTC.

updated_atstring

Quando a lista foi atualizada pela última vez.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email_verification_list.created",
  "object": {
    "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
    "object": "email_verification_list",
    "name": "October newsletter import",
    "status": "processing",
    "stats": {
      "total_emails": 1000,
      "processed_emails": 0,
      "successful_verifications": 0,
      "failed_verifications": 0,
      "pending_emails": 1000,
      "results": {
        "safe": 0,
        "role": 0,
        "catch_all": 0,
        "unknown": 0,
        "inbox_full": 0,
        "disabled": 0,
        "disposable": 0,
        "invalid": 0
      }
    },
    "created_at": "2026-10-01T10:30:02.441000+00:00",
    "updated_at": "2026-10-01T10:30:02.502000+00:00"
  },
  "data": {
    "object": {
      "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
      "object": "email_verification_list",
      "name": "October newsletter import",
      "status": "processing",
      "stats": {
        "total_emails": 1000,
        "processed_emails": 0,
        "successful_verifications": 0,
        "failed_verifications": 0,
        "pending_emails": 1000,
        "results": {
          "safe": 0,
          "role": 0,
          "catch_all": 0,
          "unknown": 0,
          "inbox_full": 0,
          "disabled": 0,
          "disposable": 0,
          "invalid": 0
        }
      },
      "created_at": "2026-10-01T10:30:02.441000+00:00",
      "updated_at": "2026-10-01T10:30:02.502000+00:00"
    }
  }
}

email_verification_list.updated

Enviado quando todos os endereços de uma lista de verificação têm um resultado final e o status da lista muda para completed. stats tem as contagens finais, e stats.results, o número de endereços com cada resultado. Leia os resultados com Listar resultados ou baixe-os com Exportar resultados.

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_verification_list.updated.

objectobject

A lista de verificação 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 lista de verificação

idstring

ID da lista (evl_…).

objectstring

Sempre email_verification_list.

namestring

Nome da lista.

statusstring

processing em email_verification_list.created, completed em email_verification_list.updated.

statsobject

Contagens: total_emails, processed_emails, successful_verifications, failed_verifications e pending_emails, além de results com os endereços concluídos por resultado. Consulte Estatísticas.

created_atstring

Quando a lista foi criada, em ISO 8601 com deslocamento UTC.

updated_atstring

Quando a lista foi atualizada pela última vez.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email_verification_list.updated",
  "object": {
    "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
    "object": "email_verification_list",
    "name": "October newsletter import",
    "status": "completed",
    "stats": {
      "total_emails": 1000,
      "processed_emails": 1000,
      "successful_verifications": 996,
      "failed_verifications": 4,
      "pending_emails": 0,
      "results": {
        "safe": 702,
        "role": 41,
        "catch_all": 88,
        "unknown": 37,
        "inbox_full": 3,
        "disabled": 6,
        "disposable": 12,
        "invalid": 107
      }
    },
    "created_at": "2026-10-01T10:30:02.441000+00:00",
    "updated_at": "2026-10-01T10:41:57.020000+00:00"
  },
  "data": {
    "object": {
      "id": "evl_2xLe7Hc2Vq9Nb4Wt1Ys6Kd3Rf8a",
      "object": "email_verification_list",
      "name": "October newsletter import",
      "status": "completed",
      "stats": {
        "total_emails": 1000,
        "processed_emails": 1000,
        "successful_verifications": 996,
        "failed_verifications": 4,
        "pending_emails": 0,
        "results": {
          "safe": 702,
          "role": 41,
          "catch_all": 88,
          "unknown": 37,
          "inbox_full": 3,
          "disabled": 6,
          "disposable": 12,
          "invalid": 107
        }
      },
      "created_at": "2026-10-01T10:30:02.441000+00:00",
      "updated_at": "2026-10-01T10:41:57.020000+00:00"
    }
  }
}

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.