Události segmentů

Kontakty, které vstoupí do sledovaného segmentu, nebo ho opustí.

segment.contact_added
segment.contact_removed

segment.contact_added

Odesílá se, když kontakt začne odpovídat sledovanému segmentu. Segmenty, které nejsou sledované, tuto událost neodesílají. Neodesílá ji ani první zápis členů po vytvoření sledovaného segmentu nebo po obnovení sledování.

Stejný vstup spouští automatizace se spouštěčem Added to segment a splní cíle a kroky Wait until, které na tuto událost čekají, pokud reason není segment_updated.

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 segment.contact_added.

objectobject

Změna členství, kterou událost popisuje. 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 členství v segmentu

objectstring

Vždy segment_membership.

segmentobject

id a name segmentu.

contactobject

Kontakt: id, email, first_name, last_name a custom_fields.

reasonstring

Proč kontakt vstoupil: contact, když se změnily kontakty, včetně importů a smazaných seznamů kontaktů, schedule, když ho našla denní synchronizace, například protože teď odpovídá datové pravidlo, nebo segment_updated, když se upravil zdroj nebo filtry segmentu.

joined_atstring

Kdy Emailit vstup zaznamenal, ve formátu ISO 8601 s posunem vůči UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "segment.contact_added",
  "object": {
    "object": "segment_membership",
    "segment": {
      "id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
      "name": "Pro customers renewing soon"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "plan": "pro"
      }
    },
    "reason": "contact",
    "joined_at": "2026-10-18T12:00:00.000000+00:00"
  },
  "data": {
    "object": {
      "object": "segment_membership",
      "segment": {
        "id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
        "name": "Pro customers renewing soon"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "plan": "pro"
        }
      },
      "reason": "contact",
      "joined_at": "2026-10-18T12:00:00.000000+00:00"
    }
  }
}

segment.contact_removed

Odesílá se, když kontakt přestane odpovídat sledovanému segmentu. Segmenty, které nejsou sledované, tuto událost neodesílají a neodesílá se ani u kontaktů, které odejdou kvůli smazání.

Stejný odchod spouští automatizace se spouštěčem Removed from segment a ukončuje spuštění s touto podmínkou ukončení, pokud reason není segment_updated.

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

Pole

event_idstring

typestring

Vždy segment.contact_removed.

objectobject

Změna členství, kterou událost popisuje. 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 členství v segmentu

objectstring

Vždy segment_membership.

segmentobject

id a name segmentu.

contactobject

Kontakt v aktuální podobě: id, email, first_name, last_name a custom_fields.

reasonstring

Proč kontakt odešel: contact, když se změnily kontakty, včetně importů a smazaných seznamů kontaktů, schedule, když ho našla denní synchronizace, například protože už neodpovídá datové pravidlo, nebo segment_updated, když se upravil zdroj nebo filtry segmentu.

left_atstring

Kdy Emailit odchod zaznamenal, ve formátu ISO 8601 s posunem vůči UTC.

JSON

{
  "event_id": "evt_2xLd4Ks8Vp1Rm6Wc3Nt9Bh5Qy0e",
  "type": "segment.contact_removed",
  "object": {
    "object": "segment_membership",
    "segment": {
      "id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
      "name": "Pro customers renewing soon"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "plan": "pro",
        "renews_on": "2026-12-01"
      }
    },
    "reason": "schedule",
    "left_at": "2026-10-18T00:30:05.000000+00:00"
  },
  "data": {
    "object": {
      "object": "segment_membership",
      "segment": {
        "id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
        "name": "Pro customers renewing soon"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "plan": "pro",
          "renews_on": "2026-12-01"
        }
      },
      "reason": "schedule",
      "left_at": "2026-10-18T00:30:05.000000+00:00"
    }
  }
}