# Události odběratelů

> Kontakty přidané do seznamu, v něm změněné, do něj znovu přidané nebo z něj odebrané.



## subscriber.created

> Odesílá se, když se kontakt přidá do seznamu kontaktů přes API, ve webovém rozhraní nebo vytvořením kontaktu se seznamy.

# subscriber.created

Odesílá se, když se kontakt přidá do seznamu kontaktů přes endpoint [Přidání odběratele](/cs/docs/api-reference/audiences/subscribers/add/), nebo když vytvoříte či upravíte kontakt s polem `audiences`. Přidání kontaktu, který se ze seznamu dříve odhlásil, místo toho vyvolá [`subscriber.updated`](/cs/docs/webhooks/events/subscriber/updated/) a [`subscriber.resubscribed`](/cs/docs/webhooks/events/subscriber/resubscribed/).

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": "subscriber.created",
  "object": {
    "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
    "object": "subscriber",
    "subscribed": true,
    "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
    "unsubscribed_at": null,
    "audience": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "name": "Newsletter"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      }
    },
    "created_at": "2026-09-20T14:22:09.418302+00:00"
  },
  "data": {
    "object": {
      "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
      "object": "subscriber",
      "subscribed": true,
      "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
      "unsubscribed_at": null,
      "audience": {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "name": "Newsletter"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "company": "Analytical Engines"
        }
      },
      "created_at": "2026-09-20T14:22:09.418302+00:00"
    }
  }
}
```

## 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 `subscriber.created`.

- `object` (object): Odběratel, 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 odběratele

- `id` (string): ID odběratele (`sub_…`). Odběratel je členství jednoho kontaktu v jednom seznamu kontaktů.

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

- `subscribed` (boolean): Jestli je kontakt v seznamu kontaktů přihlášený k odběru.

- `subscribed_at` (string | null): Kdy se kontakt přihlásil, nebo `null`.

- `unsubscribed_at` (string | null): Kdy se kontakt odhlásil, nebo `null`.

- `audience` (object): `id` a `name` seznamu kontaktů.

- `contact` (object): Kontakt: `id`, `email`, `first_name`, `last_name` a `custom_fields`.

- `created_at` (string): Kdy byl kontakt přidán do seznamu kontaktů, ve formátu ISO 8601 s posunem vůči UTC.

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

## subscriber.updated

> Odesílá se, když se odběratel změní, včetně případů, kdy se kontakt ze seznamu kontaktů odhlásí nebo se do něj vrátí.

# subscriber.updated

Odesílá se, když se odběratel změní: upravíte ho přes endpoint [Úprava odběratele](/cs/docs/api-reference/audiences/subscribers/update/), kontakt se odhlásí či znovu přihlásí nebo se do seznamu kontaktů znovu přidá kontakt, který se dříve odhlásil. Pokud změnu způsobilo odhlášení nebo opětovné přihlášení, obsahuje pole `previous` původní hodnoty.

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": "subscriber.updated",
  "object": {
    "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
    "object": "subscriber",
    "subscribed": false,
    "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
    "unsubscribed_at": "2026-10-01T10:02:14.000000+00:00",
    "audience": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "name": "Newsletter"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      }
    },
    "updated_at": "2026-10-01T10:02:14.307000+00:00",
    "created_at": "2026-09-20T14:22:09.418302+00:00",
    "previous": {
      "subscribed": true,
      "unsubscribed_at": null
    }
  },
  "data": {
    "object": {
      "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
      "object": "subscriber",
      "subscribed": false,
      "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
      "unsubscribed_at": "2026-10-01T10:02:14.000000+00:00",
      "audience": {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "name": "Newsletter"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "company": "Analytical Engines"
        }
      },
      "updated_at": "2026-10-01T10:02:14.307000+00:00",
      "created_at": "2026-09-20T14:22:09.418302+00:00",
      "previous": {
        "subscribed": true,
        "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 `subscriber.updated`.

- `object` (object): Odběratel, 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 odběratele

- `id` (string): ID odběratele (`sub_…`). Odběratel je členství jednoho kontaktu v jednom seznamu kontaktů.

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

- `subscribed` (boolean): Jestli je kontakt v seznamu kontaktů přihlášený k odběru.

- `subscribed_at` (string | null): Kdy se kontakt přihlásil, nebo `null`.

- `unsubscribed_at` (string | null): Kdy se kontakt odhlásil, nebo `null`.

- `audience` (object): `id` a `name` seznamu kontaktů.

- `contact` (object): Kontakt: `id`, `email`, `first_name`, `last_name` a `custom_fields`.

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

- `created_at` (string): Kdy byl kontakt přidán do seznamu kontaktů.

- `previous` (object): Původní hodnoty, uvedené, pokud se kontakt odhlásil nebo znovu přihlásil: `subscribed` a `unsubscribed_at`. U ostatních změn chybí.

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

## subscriber.resubscribed

> Odesílá se, když znovu přidáte kontakt do seznamu kontaktů, ze kterého se odhlásil. Není v seznamu událostí ve webovém rozhraní.

# subscriber.resubscribed

Odesílá se, když přes endpoint [Přidání odběratele](/cs/docs/api-reference/audiences/subscribers/add/) přidáte kontakt do seznamu kontaktů, ze kterého se odhlásil. Emailit odešle také [`subscriber.updated`](/cs/docs/webhooks/events/subscriber/updated/) se stejným odběratelem.

Událost `subscriber.resubscribed` v seznamu událostí ve webovém rozhraní není. Dostanete ji u webhooků se zapnutým `all_events`, nebo když ji přidáte do pole `events` přes endpoint [Úprava webhooku](/cs/docs/api-reference/webhooks/update/).

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": "subscriber.resubscribed",
  "object": {
    "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
    "object": "subscriber",
    "subscribed": true,
    "subscribed_at": "2026-10-01T10:02:14.307000+00:00",
    "unsubscribed_at": null,
    "audience": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "name": "Newsletter"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      }
    },
    "updated_at": "2026-10-01T10:02:14.307000+00:00",
    "created_at": "2026-09-20T14:22:09.418302+00:00",
    "resubscribed": true
  },
  "data": {
    "object": {
      "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
      "object": "subscriber",
      "subscribed": true,
      "subscribed_at": "2026-10-01T10:02:14.307000+00:00",
      "unsubscribed_at": null,
      "audience": {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "name": "Newsletter"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "company": "Analytical Engines"
        }
      },
      "updated_at": "2026-10-01T10:02:14.307000+00:00",
      "created_at": "2026-09-20T14:22:09.418302+00:00",
      "resubscribed": true
    }
  }
}
```

## 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 `subscriber.resubscribed`.

- `object` (object): Odběratel, 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 odběratele

- `id` (string): ID odběratele (`sub_…`). Odběratel je členství jednoho kontaktu v jednom seznamu kontaktů.

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

- `subscribed` (boolean): Jestli je kontakt v seznamu kontaktů přihlášený k odběru.

- `subscribed_at` (string | null): Kdy se kontakt přihlásil, nebo `null`.

- `unsubscribed_at` (string | null): Kdy se kontakt odhlásil, nebo `null`.

- `audience` (object): `id` a `name` seznamu kontaktů.

- `contact` (object): Kontakt: `id`, `email`, `first_name`, `last_name` a `custom_fields`.

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

- `created_at` (string): Kdy byl kontakt přidán do seznamu kontaktů.

- `resubscribed` (boolean): Vždy `true`.

---
Zdroj: https://emailit.com/cs/docs/webhooks/events/subscriber/subscriber-resubscribed/

## subscriber.deleted

> Odesílá se, když se kontakt odebere ze seznamu kontaktů, a to i při smazání samotného kontaktu.

# subscriber.deleted

Odesílá se, když se kontakt odebere ze seznamu kontaktů: přes endpoint [Smazání odběratele](/cs/docs/api-reference/audiences/subscribers/delete/), když změníte pole `audiences` kontaktu nebo když kontakt smažete. Obsahem je odběratel ve stavu před odebráním.

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": "subscriber.deleted",
  "object": {
    "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
    "object": "subscriber",
    "subscribed": true,
    "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
    "unsubscribed_at": null,
    "audience": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "name": "Newsletter"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      }
    },
    "updated_at": "2026-09-20T14:22:09.418302+00:00",
    "created_at": "2026-09-20T14:22:09.418302+00:00"
  },
  "data": {
    "object": {
      "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
      "object": "subscriber",
      "subscribed": true,
      "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
      "unsubscribed_at": null,
      "audience": {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "name": "Newsletter"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "company": "Analytical Engines"
        }
      },
      "updated_at": "2026-09-20T14:22:09.418302+00:00",
      "created_at": "2026-09-20T14:22:09.418302+00:00"
    }
  }
}
```

## 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 `subscriber.deleted`.

- `object` (object): Odběratel, 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 odběratele

- `id` (string): ID odběratele (`sub_…`). Odběratel je členství jednoho kontaktu v jednom seznamu kontaktů.

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

- `subscribed` (boolean): Jestli je kontakt v seznamu kontaktů přihlášený k odběru.

- `subscribed_at` (string | null): Kdy se kontakt přihlásil, nebo `null`.

- `unsubscribed_at` (string | null): Kdy se kontakt odhlásil, nebo `null`.

- `audience` (object): `id` a `name` seznamu kontaktů.

- `contact` (object): Kontakt: `id`, `email`, `first_name`, `last_name` a `custom_fields`.

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

- `created_at` (string): Kdy byl kontakt přidán do seznamu kontaktů.

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