---
updatedAt: 2026-06-28T17:53:44.000Z
---

Fetch the complete documentation index at: https://developers.taboola.com/backstage-api/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# First Party Audience Onboarding

First Party Audience onboarding is a specialized API that allows you to:

1. Create an *empty* **First Party Audience**.
2. Add (/remove) users to (/from) a **First Party Audience** *that you created*. (This operation is**not** supported for **other** audience types - e.g. **DMP-managed** audiences.)

*Targeting* for these First Party Audiences is provided via [My Audience Targeting](https://developers.taboola.com/backstage-api/reference/get-my-audience-targeting) (see below).

## Supported Countries

Support for a given country is determined by the **expected match rate**. If a country does not appear in the relevant list (below), then it's unlikely we'll be able to identify the users and the audience will remain very small.

> 📘
>
> If you have questions about a specific country, feel free to reach out to your **Taboola Account Manager**.

### Supported countries for email IDs

```json Supported for email IDs
To expand the list, select the JSON tab.
```
```json
{
  "EMAIL": [
    {
      "label": "United States",
      "value": "US"
    },
    {
      "label": "Canada",
      "value": "CA"
    },
    {
      "label": "United Kingdom",
      "value": "UK"
    },
    {
      "label": "India",
      "value": "IN"
    },
    {
      "label": "Brazil",
      "value": "BR"
    },
    {
      "label": "France",
      "value": "FR"
    },
    {
      "label": "Australia",
      "value": "AU"
    },
    {
      "label": "Israel",
      "value": "IL"
    },
    {
      "label": "Greece",
      "value": "GR"
    },
    {
      "label": "New Zealand",
      "value": "NZ"
    },
    {
      "label": "Germany",
      "value": "DE"
    },
    {
      "label": "Japan",
      "value": "JP"
    },
    {
      "label": "Mexico",
      "value": "MX"
    },
    {
      "label": "Spain",
      "value": "ES"
    },
    {
      "label": "Italy",
      "value": "IT"
    },
    {
      "label": "Turkey",
      "value": "TR"
    },
    {
      "label": "Argentina",
      "value": "AR"
    },
    {
      "label": "Colombia",
      "value": "CO"
    },
    {
      "label": "South Africa",
      "value": "ZA"
    },
    {
      "label": "Portugal",
      "value": "PT"
    },
    {
      "label": "Switzerland",
      "value": "CH"
    },
    {
      "label": "Singapore",
      "value": "SG"
    },
    {
      "label": "Uruguay",
      "value": "UY"
    },
    {
      "label": "Puerto Rico",
      "value": "PR"
    },
    {
      "label": "Panama",
      "value": "PA"
    },
    {
      "label": "Azerbaijan",
      "value": "AZ"
    }
  ]
}
```

### Supported countries for device IDs

```json Supported for device IDs
To expand the list, select the JSON tab.
```
```json
{
  "DEVICE_ID": [
    {
      "label": "United States",
      "value": "US"
    },
    {
      "label": "Canada",
      "value": "CA"
    },
    {
      "label": "United Kingdom",
      "value": "UK"
    },
    {
      "label": "India",
      "value": "IN"
    },
    {
      "label": "Brazil",
      "value": "BR"
    },
    {
      "label": "France",
      "value": "FR"
    },
    {
      "label": "Australia",
      "value": "AU"
    },
    {
      "label": "Israel",
      "value": "IL"
    },
    {
      "label": "Greece",
      "value": "GR"
    },
    {
      "label": "Germany",
      "value": "DE"
    },
    {
      "label": "Japan",
      "value": "JP"
    },
    {
      "label": "Mexico",
      "value": "MX"
    },
    {
      "label": "Spain",
      "value": "ES"
    },
    {
      "label": "Italy",
      "value": "IT"
    },
    {
      "label": "Turkey",
      "value": "TR"
    },
    {
      "label": "Argentina",
      "value": "AR"
    },
    {
      "label": "Colombia",
      "value": "CO"
    },
    {
      "label": "South Korea",
      "value": "KO"
    },
    {
      "label": "Poland",
      "value": "PL"
    },
    {
      "label": "Thailand",
      "value": "TH"
    },
    {
      "label": "Indonesia",
      "value": "ID"
    },
    {
      "label": "Vietnam",
      "value": "VN"
    },
    {
      "label": "Egypt",
      "value": "EG"
    }
  ]
}
```