Události seznamů

Vytvořené, upravené nebo smazané seznamy kontaktů.

audience.created
audience.updated
audience.deleted

audience.created

Odesílá se, když se vytvoří seznam kontaktů, například přes endpoint Vytvoření seznamu kontaktů.

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

objectobject

Seznam kontaktů, kterého se událost týká. Jeho 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 seznamu kontaktů

idstring

ID seznamu kontaktů (aud_…).

objectstring

Vždy audience.

namestring

Název seznamu kontaktů.

created_atstring

Kdy byl seznam kontaktů vytvořen, ve formátu ISO 8601 s posunem vůči UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "audience.created",
  "object": {
    "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
    "object": "audience",
    "name": "Newsletter",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "object": "audience",
      "name": "Newsletter",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

audience.updated

Odesílá se, když se seznam kontaktů změní, například když ho přejmenujete přes endpoint Úprava seznamu kontaktů. Změny odběratelů místo toho vyvolávají události odběratelů.

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

Pole

event_idstring

typestring

Vždy audience.updated.

objectobject

Seznam kontaktů, kterého se událost týká. Jeho 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 seznamu kontaktů

idstring

ID seznamu kontaktů (aud_…).

objectstring

Vždy audience.

namestring

Název seznamu kontaktů.

updated_atstring

Kdy byl seznam kontaktů naposledy upraven, ve formátu ISO 8601 s posunem vůči UTC.

created_atstring

Kdy byl seznam kontaktů vytvořen.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "audience.updated",
  "object": {
    "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
    "object": "audience",
    "name": "Monthly newsletter",
    "updated_at": "2026-10-01T10:02:14.307000+00:00",
    "created_at": "2026-09-15T12:00:41.305000+00:00"
  },
  "data": {
    "object": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "object": "audience",
      "name": "Monthly newsletter",
      "updated_at": "2026-10-01T10:02:14.307000+00:00",
      "created_at": "2026-09-15T12:00:41.305000+00:00"
    }
  }
}

audience.deleted

Odesílá se, když se smaže seznam kontaktů, například přes endpoint Smazání seznamu kontaktů. Obsahem je seznam ve stavu, v jakém byl před smazáním.

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

Pole

event_idstring

typestring

Vždy audience.deleted.

objectobject

Seznam kontaktů, kterého se událost týká. Jeho 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 seznamu kontaktů

idstring

ID seznamu kontaktů (aud_…).

objectstring

Vždy audience.

namestring

Název seznamu kontaktů.

updated_atstring

Kdy byl seznam kontaktů naposledy upraven, ve formátu ISO 8601 s posunem vůči UTC.

created_atstring

Kdy byl seznam kontaktů vytvořen.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "audience.deleted",
  "object": {
    "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
    "object": "audience",
    "name": "Monthly newsletter",
    "updated_at": "2026-09-30T08:14:02.771000+00:00",
    "created_at": "2026-09-15T12:00:41.305000+00:00"
  },
  "data": {
    "object": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "object": "audience",
      "name": "Monthly newsletter",
      "updated_at": "2026-09-30T08:14:02.771000+00:00",
      "created_at": "2026-09-15T12:00:41.305000+00:00"
    }
  }
}