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

# Share Audience

> Shares an X Ads custom audience with another ad account, read-only or read-write

Shares an X Ads custom audience with another ad account, read-only or read-write. Both accounts must belong to X business organizations, otherwise X rejects the request.

|                       |                        |
| --------------------- | ---------------------- |
| **App**               | X Ads                  |
| **Operation ID**      | `x_ads_share_audience` |
| **Type**              | Action                 |
| **Connection**        | `x_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 the X Ads account that owns the audience.                                                                                      |
| `audience_id`        | string or SelectItem             | Yes      | -           | Custom audience ID to share.                                                                                                          |
| `granted_account_id` | string                           | Yes      | -           | The X Ads account ID to grant access to. Must be a different account: X rejects sharing an audience back to the account that owns it. |
| `permission_level`   | enum (`READ_ONLY`, `READ_WRITE`) | No       | `READ_ONLY` | Access to grant: READ\_ONLY (default, the other account can target the audience) or READ\_WRITE (it can also modify members).         |

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

## Output

**Type**: `Dict`

Returns the created audience permission.

**Fields**: dynamic (depend on the inputs)