Události kontaktů

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

contact.created
contact.updated
contact.deleted

contact.created

Odesílá se, když se kontakt vytvoří přes endpoint Vytvoření kontaktu. Pokud předáte pole audiences, Emailit odešle také subscriber.created pro každý seznam 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 contact.created.

objectobject

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 kontaktu

idstring

ID kontaktu (con_…).

objectstring

Vždy contact.

emailstring

Adresa kontaktu, malými písmeny.

first_namestring | null

Jméno.

last_namestring | null

Příjmení.

custom_fieldsobject

Hodnoty vlastních polí s klíčem podle pole. Viz Vlastní pole.

unsubscribedboolean

Jestli je kontakt odhlášený ze všech kampaní.

created_atstring

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

audiencesobject[]

Seznamy kontaktů, do kterých kontakt patří. Každá položka obsahuje id seznamu a objekt subscriber s poli id, subscribed, subscribed_at a unsubscribed_at.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "contact.created",
  "object": {
    "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
    "object": "contact",
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": {
      "company": "Analytical Engines"
    },
    "unsubscribed": false,
    "created_at": "2026-09-20T14:22:09.418000+00:00",
    "audiences": [
      {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "subscriber": {
          "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
          "subscribed": true,
          "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
          "unsubscribed_at": null
        }
      }
    ]
  },
  "data": {
    "object": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "object": "contact",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      },
      "unsubscribed": false,
      "created_at": "2026-09-20T14:22:09.418000+00:00",
      "audiences": [
        {
          "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
          "subscriber": {
            "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
            "subscribed": true,
            "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
            "unsubscribed_at": null
          }
        }
      ]
    }
  }
}

contact.updated

Odesílá se, když se kontakt změní přes endpoint Úprava kontaktu nebo akcemi unsubscribe a resubscribe hromadných akcí s kontakty. Změny v seznamech kontaktů vyvolávají také 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 contact.updated.

objectobject

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 kontaktu

idstring

ID kontaktu (con_…).

objectstring

Vždy contact.

emailstring

Adresa kontaktu, malými písmeny.

first_namestring | null

Jméno.

last_namestring | null

Příjmení.

custom_fieldsobject

Hodnoty vlastních polí s klíčem podle pole. Viz Vlastní pole.

unsubscribedboolean

Jestli je kontakt odhlášený ze všech kampaní.

updated_atstring

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

created_atstring

Kdy byl kontakt vytvořen.

audiencesobject[]

Seznamy kontaktů, do kterých kontakt patří. Každá položka obsahuje id seznamu a objekt subscriber s poli id, subscribed, subscribed_at a unsubscribed_at.

previousobject

Původní hodnoty těch z polí email, first_name, last_name, unsubscribed a custom_fields, která se změnila. Chybí, pokud se žádné z nich nezměnilo.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "contact.updated",
  "object": {
    "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
    "object": "contact",
    "email": "ada@example.com",
    "first_name": "Augusta Ada",
    "last_name": "Lovelace",
    "custom_fields": {
      "company": "Analytical Engines"
    },
    "unsubscribed": false,
    "updated_at": "2026-10-01T10:02:14.307000+00:00",
    "created_at": "2026-09-20T14:22:09.418000+00:00",
    "audiences": [
      {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "subscriber": {
          "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
          "subscribed": true,
          "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
          "unsubscribed_at": null
        }
      }
    ],
    "previous": {
      "first_name": "Ada"
    }
  },
  "data": {
    "object": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "object": "contact",
      "email": "ada@example.com",
      "first_name": "Augusta Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      },
      "unsubscribed": false,
      "updated_at": "2026-10-01T10:02:14.307000+00:00",
      "created_at": "2026-09-20T14:22:09.418000+00:00",
      "audiences": [
        {
          "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
          "subscriber": {
            "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
            "subscribed": true,
            "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
            "unsubscribed_at": null
          }
        }
      ],
      "previous": {
        "first_name": "Ada"
      }
    }
  }
}

contact.deleted

Odesílá se, když se kontakt smaže přes endpoint Smazání kontaktu nebo hromadnou akcí delete. Emailit nejdřív odešle subscriber.deleted pro každý seznam kontaktů, do kterého kontakt patřil.

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

Pole

event_idstring

typestring

Vždy contact.deleted.

objectobject

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 kontaktu

idstring

ID kontaktu (con_…).

objectstring

Vždy contact.

emailstring

Adresa kontaktu, malými písmeny.

first_namestring | null

Jméno.

last_namestring | null

Příjmení.

custom_fieldsobject

Hodnoty vlastních polí s klíčem podle pole. Viz Vlastní pole.

unsubscribedboolean

Jestli je kontakt odhlášený ze všech kampaní.

updated_atstring

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

created_atstring

Kdy byl kontakt vytvořen.

audiencesobject[]

Seznamy kontaktů, do kterých kontakt patří. Každá položka obsahuje id seznamu a objekt subscriber s poli id, subscribed, subscribed_at a unsubscribed_at.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "contact.deleted",
  "object": {
    "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
    "object": "contact",
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": {
      "company": "Analytical Engines"
    },
    "unsubscribed": false,
    "updated_at": "2026-09-30T16:48:55.120000+00:00",
    "created_at": "2026-09-20T14:22:09.418000+00:00",
    "audiences": [
      {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "subscriber": {
          "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
          "subscribed": true,
          "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
          "unsubscribed_at": null
        }
      }
    ]
  },
  "data": {
    "object": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "object": "contact",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      },
      "unsubscribed": false,
      "updated_at": "2026-09-30T16:48:55.120000+00:00",
      "created_at": "2026-09-20T14:22:09.418000+00:00",
      "audiences": [
        {
          "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
          "subscriber": {
            "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
            "subscribed": true,
            "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
            "unsubscribed_at": null
          }
        }
      ]
    }
  }
}