Přejít na obsah
Dokumentace

Události blokovaných adres

Vytvořené, upravené nebo smazané blokace.

suppression.created

Odesílá se, když se blokace přidá přes endpoint Vytvoření blokace, importem CSV ve webovém rozhraní nebo krokem automatizace Add to suppressions. Blokace, které Emailit přidává automaticky po nedoručení a stížnostech, tuto událost nevyvolávají; místo toho sledujte email.bounced a email.complained.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

ID události (evt_…). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint Načtení události.

typestring

Vždy suppression.created.

objectobject

Blokace, které se událost týká. Její pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt blokace

idstring

ID blokace (sup_…).

objectstring

Vždy suppression.

emailstring

Zablokovaná adresa, malými písmeny.

typestring

recipient, bounce, complaint nebo unsubscribe. Odesílání přes API a SMTP zastaví jen blokace typu recipient; kampaně přeskakují všechny typy.

reasonstring | null

Důvod blokace.

created_atstring

Kdy byla blokace vytvořena, ve formátu ISO 8601 s posunem vůči UTC.

keep_untilstring | null

Kdy blokace vyprší, nebo null, pokud je trvalá.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "suppression.created",
  "object": {
    "id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
    "object": "suppression",
    "email": "ada@example.com",
    "type": "recipient",
    "reason": "manual",
    "created_at": "2026-10-01T09:30:12.481000+00:00",
    "keep_until": null
  },
  "data": {
    "object": {
      "id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
      "object": "suppression",
      "email": "ada@example.com",
      "type": "recipient",
      "reason": "manual",
      "created_at": "2026-10-01T09:30:12.481000+00:00",
      "keep_until": null
    }
  }
}

suppression.updated

Odesílá se, když se blokace změní přes endpoint Úprava blokace.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

ID události (evt_…). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint Načtení události.

typestring

Vždy suppression.updated.

objectobject

Blokace, které se událost týká. Její pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt blokace

idstring

ID blokace (sup_…).

objectstring

Vždy suppression.

emailstring

Zablokovaná adresa, malými písmeny.

typestring

recipient, bounce, complaint nebo unsubscribe. Odesílání přes API a SMTP zastaví jen blokace typu recipient; kampaně přeskakují všechny typy.

reasonstring | null

Důvod blokace.

created_atstring

Kdy byla blokace vytvořena, ve formátu ISO 8601 s posunem vůči UTC.

keep_untilstring | null

Kdy blokace vyprší, nebo null, pokud je trvalá.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "suppression.updated",
  "object": {
    "id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
    "object": "suppression",
    "email": "ada@example.com",
    "type": "recipient",
    "reason": "Asked to pause invoices until January",
    "created_at": "2026-10-01T09:30:12.481000+00:00",
    "keep_until": "2027-01-01T00:00:00.000000+00:00"
  },
  "data": {
    "object": {
      "id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
      "object": "suppression",
      "email": "ada@example.com",
      "type": "recipient",
      "reason": "Asked to pause invoices until January",
      "created_at": "2026-10-01T09:30:12.481000+00:00",
      "keep_until": "2027-01-01T00:00:00.000000+00:00"
    }
  }
}

suppression.deleted

Odesílá se, když se blokace smaže přes endpoint Smazání blokace. Blokace, která vypršela, zůstává v seznamu a tuto událost nevyvolá; nevyvolá ji ani krok automatizace Remove from suppressions.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

ID události (evt_…). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint Načtení události.

typestring

Vždy suppression.deleted.

objectobject

Blokace, které se událost týká. Její pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt blokace

idstring

ID blokace (sup_…).

objectstring

Vždy suppression.

emailstring

Zablokovaná adresa, malými písmeny.

typestring

recipient, bounce, complaint nebo unsubscribe. Odesílání přes API a SMTP zastaví jen blokace typu recipient; kampaně přeskakují všechny typy.

reasonstring | null

Důvod blokace.

created_atstring

Kdy byla blokace vytvořena, ve formátu ISO 8601 s posunem vůči UTC.

keep_untilstring | null

Kdy blokace vyprší, nebo null, pokud je trvalá.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "suppression.deleted",
  "object": {
    "id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
    "object": "suppression",
    "email": "ada@example.com",
    "type": "recipient",
    "reason": "manual",
    "created_at": "2026-10-01T09:30:12.481000+00:00",
    "keep_until": null
  },
  "data": {
    "object": {
      "id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
      "object": "suppression",
      "email": "ada@example.com",
      "type": "recipient",
      "reason": "manual",
      "created_at": "2026-10-01T09:30:12.481000+00:00",
      "keep_until": null
    }
  }
}

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.