Audience events

Audiences created, updated or deleted.

audience.created
audience.updated
audience.deleted

audience.created

Sent when an audience is created, for example with Create an audience.

Webhook requests carry a JSON array of events like this one; see Webhook requests.

Fields

event_idstring

Event ID (evt_…). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with Retrieve an event.

typestring

Always audience.created.

objectobject

The audience the event describes. Its fields are listed below.

data.objectobject

The same object again, in the shape that the Events API returns in data.

Audience object

idstring

Audience ID (aud_…).

objectstring

Always audience.

namestring

Audience name.

created_atstring

When the audience was created, in ISO 8601 with a UTC offset.

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

Sent when an audience changes, for example when you rename it with Update an audience. Subscriber changes send subscriber events instead.

Webhook requests carry a JSON array of events like this one; see Webhook requests.

Fields

event_idstring

Event ID (evt_…). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with Retrieve an event.

typestring

Always audience.updated.

objectobject

The audience the event describes. Its fields are listed below.

data.objectobject

The same object again, in the shape that the Events API returns in data.

Audience object

idstring

Audience ID (aud_…).

objectstring

Always audience.

namestring

Audience name.

updated_atstring

When the audience was last updated, in ISO 8601 with a UTC offset.

created_atstring

When the audience was created.

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

Sent when an audience is deleted, for example with Delete an audience. The payload is the audience as it was before it was deleted.

Webhook requests carry a JSON array of events like this one; see Webhook requests.

Fields

event_idstring

Event ID (evt_…). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with Retrieve an event.

typestring

Always audience.deleted.

objectobject

The audience the event describes. Its fields are listed below.

data.objectobject

The same object again, in the shape that the Events API returns in data.

Audience object

idstring

Audience ID (aud_…).

objectstring

Always audience.

namestring

Audience name.

updated_atstring

When the audience was last updated, in ISO 8601 with a UTC offset.

created_atstring

When the audience was created.

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