# Události kontaktů

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



## contact.created

> Odesílá se, když se kontakt vytvoří přes API nebo ve webovém rozhraní. Obsahuje seznamy kontaktů, do kterých byl přidán.

# contact.created

Odesílá se, když se kontakt vytvoří přes endpoint [Vytvoření kontaktu](/cs/docs/api-reference/contacts/create/). Pokud předáte pole `audiences`, Emailit odešle také [`subscriber.created`](/cs/docs/webhooks/events/subscriber/created/) pro každý seznam kontaktů.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz [Požadavky webhooků](/cs/docs/webhooks/webhook-requests/).

```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
          }
        }
      ]
    }
  }
}
```

## Pole

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

- `type` (string): Vždy `contact.created`.

- `object` (object): Kontakt, kterého se událost týká. Jeho pole jsou uvedena níže.

- `data.object` (object): Stejný objekt ještě jednou, v podobě, v jaké ho vrací [API událostí](/cs/docs/api-reference/events/get/) v poli `data`.

### Objekt kontaktu

- `id` (string): ID kontaktu (`con_…`).

- `object` (string): Vždy `contact`.

- `email` (string): Adresa kontaktu, malými písmeny.

- `first_name` (string | null): Jméno.

- `last_name` (string | null): Příjmení.

- `custom_fields` (object): Hodnoty vlastních polí s klíčem podle pole. Viz [Vlastní pole](/cs/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Jestli je kontakt odhlášený ze všech kampaní.

- `created_at` (string): Kdy byl kontakt vytvořen, ve formátu ISO 8601 s posunem vůči UTC.

- `audiences` (object[]): 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`.

---
Zdroj: https://emailit.com/cs/docs/webhooks/events/contact/contact-created/

## contact.updated

> Odesílá se, když se kontakt změní. Obsahuje předchozí hodnoty změněných polí, například e-mailové adresy nebo jména.

# contact.updated

Odesílá se, když se kontakt změní přes endpoint [Úprava kontaktu](/cs/docs/api-reference/contacts/update/) nebo akcemi `unsubscribe` a `resubscribe` [hromadných akcí s kontakty](/cs/docs/api-reference/contacts/bulk/). Změny v seznamech kontaktů vyvolávají také [události odběratelů](/cs/docs/webhooks/events/subscriber/).

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz [Požadavky webhooků](/cs/docs/webhooks/webhook-requests/).

```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"
      }
    }
  }
}
```

## Pole

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

- `type` (string): Vždy `contact.updated`.

- `object` (object): Kontakt, kterého se událost týká. Jeho pole jsou uvedena níže.

- `data.object` (object): Stejný objekt ještě jednou, v podobě, v jaké ho vrací [API událostí](/cs/docs/api-reference/events/get/) v poli `data`.

### Objekt kontaktu

- `id` (string): ID kontaktu (`con_…`).

- `object` (string): Vždy `contact`.

- `email` (string): Adresa kontaktu, malými písmeny.

- `first_name` (string | null): Jméno.

- `last_name` (string | null): Příjmení.

- `custom_fields` (object): Hodnoty vlastních polí s klíčem podle pole. Viz [Vlastní pole](/cs/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Jestli je kontakt odhlášený ze všech kampaní.

- `updated_at` (string): Kdy byl kontakt naposledy upraven, ve formátu ISO 8601 s posunem vůči UTC.

- `created_at` (string): Kdy byl kontakt vytvořen.

- `audiences` (object[]): 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`.

- `previous` (object): 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.

---
Zdroj: https://emailit.com/cs/docs/webhooks/events/contact/contact-updated/

## contact.deleted

> Odesílá se, když se kontakt smaže. Obsahem je kontakt i s jeho seznamy ve stavu před smazáním.

# contact.deleted

Odesílá se, když se kontakt smaže přes endpoint [Smazání kontaktu](/cs/docs/api-reference/contacts/delete/) nebo hromadnou akcí `delete`. Emailit nejdřív odešle [`subscriber.deleted`](/cs/docs/webhooks/events/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ů](/cs/docs/webhooks/webhook-requests/).

```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
          }
        }
      ]
    }
  }
}
```

## Pole

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

- `type` (string): Vždy `contact.deleted`.

- `object` (object): Kontakt, kterého se událost týká. Jeho pole jsou uvedena níže.

- `data.object` (object): Stejný objekt ještě jednou, v podobě, v jaké ho vrací [API událostí](/cs/docs/api-reference/events/get/) v poli `data`.

### Objekt kontaktu

- `id` (string): ID kontaktu (`con_…`).

- `object` (string): Vždy `contact`.

- `email` (string): Adresa kontaktu, malými písmeny.

- `first_name` (string | null): Jméno.

- `last_name` (string | null): Příjmení.

- `custom_fields` (object): Hodnoty vlastních polí s klíčem podle pole. Viz [Vlastní pole](/cs/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Jestli je kontakt odhlášený ze všech kampaní.

- `updated_at` (string): Kdy byl kontakt naposledy upraven, ve formátu ISO 8601 s posunem vůči UTC.

- `created_at` (string): Kdy byl kontakt vytvořen.

- `audiences` (object[]): 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`.

---
Zdroj: https://emailit.com/cs/docs/webhooks/events/contact/contact-deleted/