---
title: "Update an audience"
description: "A partial update. A field you leave out keeps its stored value and an explicit `null` clears it. The built-in default audience can be renamed and described like any other, and renaming it changes neither `builtin` nor what it holds."
url: "https://openemail.uk/docs/api/audiences/update"
area: "API"
category: "Mailbox"
---

# Update an audience

A partial update. A field you leave out keeps its stored value and an explicit `null` clears it. The built-in default audience can be renamed and described like any other, and renaming it changes neither `builtin` nor what it holds.

`PATCH /audiences/{id}`

## PATCH /audiences/{id}

A partial update. A field you leave out keeps its stored value and an explicit `null` clears it. The built-in default audience can be renamed and described like any other, and renaming it changes neither `builtin` nor what it holds.

## Example

Needs `audiences:write`.

**curl**

```
curl -X PATCH "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71" -H "$AUTH" -H 'content-type: application/json' -d '{
  "name": "Release notes"
}'
```

**Response**

```
{
  "object": "audience",
  "id": "aud_4c1b8e2a7d9f05c36b4e8a71",
  "name": "Release notes",
  "description": "Customers who asked to hear about releases",
  "builtin": null,
  "contactCount": 3,
  "createdAt": "2026-09-18T09:10:00.000Z",
  "updatedAt": "2026-09-18T09:22:00.000Z"
}
```

> `builtin` cannot be set, moved or cleared from here.

> Renaming moves nobody. The contacts stay in the audience under its new name, and the id never changes.