> ## 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` | array of object or object or string | 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`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.