> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Audience

> Updates a Pinterest Ads audience's name, description, or rule, or removes the users matched by a rule from it (operation_type REMOVE)

Updates a Pinterest Ads audience's name, description, or rule, or removes the users matched by a rule from it (operation\_type REMOVE). Audience IDs come from pinterest\_ads\_list\_audiences.

|                       |                                 |
| --------------------- | ------------------------------- |
| **App**               | Pinterest Ads                   |
| **Operation ID**      | `pinterest_ads_update_audience` |
| **Type**              | Action                          |
| **Connection**        | `pinterest_ads` (required)      |
| **Credits per run**   | 1                               |
| **Agent / MCP tool**  | Yes                             |
| **Requires approval** | Yes (write operation)           |

## Inputs

| Field            | Type                       | Required | Default                                  | Description                                                                                                                                                                                                                          |
| ---------------- | -------------------------- | -------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `account`        | DynamicAccount             | Yes      | -                                        | Select Pinterest Ads account that owns the audience.                                                                                                                                                                                 |
| `audience_id`    | string or SelectItem       | Yes      | -                                        | Pinterest audience ID to update. Find IDs with pinterest\_ads\_list\_audiences.                                                                                                                                                      |
| `operation_type` | string or SelectableOption | No       | `{'value': 'UPDATE', 'label': 'Update'}` | UPDATE (default) applies the provided name, description, or rule changes. REMOVE removes the users matched by rule from the audience, for example a customer list.                                                                   |
| `audience_name`  | string                     | No       | -                                        | Optional new name for the audience.                                                                                                                                                                                                  |
| `description`    | string                     | No       | -                                        | Optional new audience description.                                                                                                                                                                                                   |
| `rule`           | object or string           | No       | -                                        | Optional JSON rule object, sent to Pinterest as-is. Same shapes as pinterest\_ads\_create\_audience (customer\_list\_id, visitor\_source\_id, engagement\_domain, or seed\_id based rules). Required when operation\_type is REMOVE. |

### SelectItem

| Field   | Type   | Required | Default | Description                                                                                          |
| ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `value` | string | Yes      | -       | The value of the selectable item.                                                                    |
| `label` | string | Yes      | -       | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `Dict`

Returns the updated audience ID, operation, and changed fields.

**Fields**: `audience_id`, `operation_type`, `updated_fields`, `status`