---
updatedAt: 2026-09-24T11:53:05.000Z
agentTools:
projectIndex: https://developers.taboola.com/backstage-api/llms.txt
---
# Update My Audience Targeting
Update **My Audience Targeting** for the specified campaign.
**My Audience Targeting** supports both **First Party Audiences** *and* **Custom Audiences**.
> 🚧 Request
>
> * **My Audience Targeting** supports both **First Party Audiences** *and* **Custom Audiences**.
> * The Custom Audiences are the same as those used by [Custom Audience Targeting](https://developers.taboola.com/backstage-api/reference/update-custom-audience-targeting), but have **different Audience IDs**.
> 📘 You can specify both INCLUDE and EXCLUDE.
>
> For example, you might want to *include* all female visitors that made a purchase, but *exclude* visitors above the age of 40.
>
> ***
>
> Combining INCLUDE and EXCLUDE conditions *limits* your target audience (applies an 'AND' operator).
VALID request examples:
(Follow the examples from left to right...)
```json Target ALL
{
"collection": []
}
```
```json Target Inclusions
{
"collection": [
{
"collection": [
1713658,
151037
],
"type": "INCLUDE"
}
]
}
```
```json Target Both
{
"collection": [
{
"collection": [
1713658,
151037
],
"type": "INCLUDE"
},
{
"collection": [
1898703,
1918825,
1918824
],
"type": "EXCLUDE"
}
]
}
```
```json Remove Exclusions
{
"collection": [
{
"collection": [
1713658,
151037
],
"type": "INCLUDE"
},
{
"collection": [],
"type": "EXCLUDE"
}
]
}
```
```json Retarget Inclusions As Exclusions
{
"collection": [
{
"collection": [
1713658,
151037
],
"type": "EXCLUDE"
}
]
}
```
> 🚧 Audience Targeting does *not* support a PATCH operation - the submitted values *overwrite* the old ones.
> 📘 For a successful request, the *same* object is returned in the *response*.
> 📘 Recommended Flow
>
> If you want to remove *exclusions* (but keep *inclusions*), perform the following steps:
>
> 1. Fetch the current list of inclusions.
> 2. Send a request to Target ALL (see *first* example, above).
> 3. Send a request to target the inclusions (obtained in step 1).
INVALID request examples:
```json Single Empty Array
{
"collection": [
{
"collection": [],
"type": "EXCLUDE"
}
]
}
```
```json 2 Empty Arrays
{
"collection": [
{
"collection": [],
"type": "INCLUDE"
},
{
"collection": [],
"type": "EXCLUDE"
}
]
}
```
```json 400 (Bad Request)
{
"http_status": 400,
"message": "Please select an audience",
"offending_field": "retargeting_first_party_audience"
}
```
> 🚧 At least 1 of the [Audience Targeting Restrictions](https://developers.taboola.com/backstage-api/docs/audience-targeting-restrictions-object) objects must contain a non-empty collection.
## Rate limit
> 🚧 Rate limit
>
> **Tier 1.** My-audience targeting has its own write budget, separate both from its reads and from every other targeting type.
>
> See [Rate limits](https://developers.taboola.com/backstage-api/reference/rate-limits) for the request allowance each tier carries.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "backstage-api",
"version": "1.0"
},
"servers": [
{
"url": "https://backstage.taboola.com"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "oauth2",
"flows": {
"clientCredentials": {
"tokenUrl": "https://backstage.taboola.com/backstage/oauth/token",
"scopes": {}
},
"password": {
"tokenUrl": "https://backstage.taboola.com/backstage/oauth/token",
"scopes": {}
}
}
}
}
},
"security": [
{
"sec0": []
}
],
"x-readme": {
"headers": [],
"explorer-enabled": false,
"proxy-enabled": false
},
"paths": {
"/backstage/api/1.0/{account_id}/campaigns/{campaign_id}/targeting/my_audiences": {
"post": {
"summary": "Update My Audience Targeting",
"description": "Update **My Audience Targeting** for the specified campaign.\n**My Audience Targeting** supports both **First Party Audiences** *and* **Custom Audiences**.\n\n",
"operationId": "update-my-audience-targeting",
"parameters": [
{
"name": "account_id",
"in": "path",
"description": "An *alphabetic* ID. See [Get Account Details](https://developers.taboola.com/backstage-api/reference/get-account-details).",
"schema": {
"type": "string"
},
"required": true
},
{
"name": "campaign_id",
"in": "path",
"description": "A *numeric* ID.",
"schema": {
"type": "string"
},
"required": true
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"RAW_BODY": {
"type": "string",
"description": "An [Audience Targeting Object](https://developers.taboola.com/backstage-api/reference/audience-targeting-object)",
"default": "{ \"collection\": [ { \"collection\": [ 224820, 25287 ], \"type\": \"INCLUDE\" }, { \"collection\": [ 19884, 29870 ], \"type\": \"EXCLUDE\" } ] }",
"format": "json"
}
}
}
}
}
},
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"collection\": [\n {\n \"collection\": [\n 1713658,\n 151037\n ],\n \"type\": \"INCLUDE\"\n },\n {\n \"collection\": [\n 1898703,\n 1918825,\n 1918824\n ],\n \"type\": \"EXCLUDE\"\n }\n ]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"collection": {
"type": "array",
"items": {
"type": "object",
"properties": {
"collection": {
"type": "array",
"items": {
"type": "integer",
"example": 1713658,
"default": 0
}
},
"type": {
"type": "string",
"example": "INCLUDE"
}
}
}
}
}
}
}
}
}
},
"deprecated": false
}
}
}
}
```