> ## 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.

# Manage Custom Audience

> Create, update, or remove a Google Ads custom audience defined by keywords, URLs, place categories, or apps

Create, update, or remove a Google Ads custom audience defined by keywords, URLs, place categories, or apps. Not usable through gads\_mutate

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

## Inputs

| Field                | Type                                                              | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------- | ----------------------------------------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`            | GadsAccountItem or object or array of object or string or integer | Yes      | -       | Select the Google Ads account, ask the user for it if not provided                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `action`             | string or SelectableOption                                        | Yes      | -       | What to do with the custom audience. Options: 'CREATE', 'UPDATE', 'REMOVE'                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `custom_audience_id` | string                                                            | No       | -       | The custom audience ID to update or remove. Required for UPDATE and REMOVE                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `name`               | string                                                            | No       | -       | Name of the custom audience, unique per account. Required for CREATE                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `audience_type`      | string or SelectableOption                                        | No       | -       | Type of the custom audience. New audiences can only be 'SEARCH' (people who searched these terms on Google) or 'AUTO' (Google picks interpretation per campaign goal). 'INTEREST' and 'PURCHASE\_INTENT' are legacy types kept only for existing audiences                                                                                                                                                                                                                                                     |
| `description`        | string                                                            | No       | -       | Description of the custom audience                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `members`            | string or array of object or object                               | No       | -       | Members defining the audience, as a list of objects with 'member\_type' and 'value'. member\_type options: 'KEYWORD' (search term or interest keyword), 'URL' (a website URL people browse), 'PLACE\_CATEGORY' (numeric place category ID), 'APP' (app package id like 'com.example.app'). Example: \[\{"member\_type": "KEYWORD", "value": "running shoes"}, \{"member\_type": "URL", "value": "`https://example.com/running`"}]. On UPDATE, the provided list fully replaces the audience's existing members |

### GadsAccountItem

| Field       | Type   | Required | Default | Description                                                                                                                                                    |
| ----------- | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `value`     | string | Yes      | -       |                                                                                                                                                                |
| `label`     | string | Yes      | -       |                                                                                                                                                                |
| `managerId` | string | Yes      | -       | The manager ID for the Google Ads account. Ask  user to use the dropdown to select accounts, this manager id is selected background and not shown to the user. |

### SelectableOption

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

## Output

**Type**: `Dict`

Returns the affected custom audience details.

**Fields**: `action`, `custom_audience_id`, `resource_name`