# Audience events

> Audiences created, updated or deleted.



## audience.created

> Sent when an audience is created in your workspace through the API or the dashboard. Includes its ID and name.

# audience.created

Sent when an audience is created, for example with [Create an audience](/docs/api-reference/audiences/create/).

Webhook requests carry a JSON array of events like this one; see [Webhook requests](/docs/webhooks/webhook-requests/).

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

## Fields

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

- `type` (string): Always `audience.created`.

- `object` (object): The audience the event describes. Its fields are listed below.

- `data.object` (object): The same object again, in the shape that the [Events API](/docs/api-reference/events/get/) returns in `data`.

### Audience object

- `id` (string): Audience ID (`aud_…`).

- `object` (string): Always `audience`.

- `name` (string): Audience name.

- `created_at` (string): When the audience was created, in ISO 8601 with a UTC offset.

---
Source: https://emailit.com/docs/webhooks/events/audience/audience-created/

## audience.updated

> Sent when an audience is renamed or otherwise updated through the API or the dashboard. Includes its ID and new name.

# audience.updated

Sent when an audience changes, for example when you rename it with [Update an audience](/docs/api-reference/audiences/update/). Subscriber changes send [subscriber events](/docs/webhooks/events/subscriber/) instead.

Webhook requests carry a JSON array of events like this one; see [Webhook requests](/docs/webhooks/webhook-requests/).

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

## Fields

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

- `type` (string): Always `audience.updated`.

- `object` (object): The audience the event describes. Its fields are listed below.

- `data.object` (object): The same object again, in the shape that the [Events API](/docs/api-reference/events/get/) returns in `data`.

### Audience object

- `id` (string): Audience ID (`aud_…`).

- `object` (string): Always `audience`.

- `name` (string): Audience name.

- `updated_at` (string): When the audience was last updated, in ISO 8601 with a UTC offset.

- `created_at` (string): When the audience was created.

---
Source: https://emailit.com/docs/webhooks/events/audience/audience-updated/

## audience.deleted

> Sent when an audience is deleted from your workspace. The payload is the audience as it was before deletion.

# audience.deleted

Sent when an audience is deleted, for example with [Delete an audience](/docs/api-reference/audiences/delete/). 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](/docs/webhooks/webhook-requests/).

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

## Fields

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

- `type` (string): Always `audience.deleted`.

- `object` (object): The audience the event describes. Its fields are listed below.

- `data.object` (object): The same object again, in the shape that the [Events API](/docs/api-reference/events/get/) returns in `data`.

### Audience object

- `id` (string): Audience ID (`aud_…`).

- `object` (string): Always `audience`.

- `name` (string): Audience name.

- `updated_at` (string): When the audience was last updated, in ISO 8601 with a UTC offset.

- `created_at` (string): When the audience was created.

---
Source: https://emailit.com/docs/webhooks/events/audience/audience-deleted/