---
title: "Email / Phone Number Audiences"
slug: "email-phone-number"
updated: 2026-04-21T13:50:45Z
published: 2026-04-21T13:50:45Z
canonical: "help.yahooinc.com/email-phone-number"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.yahooinc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Email / Phone Number Audiences

> [!WARNING]
> Important
> 
> This Email / Phone Number Audiences endpoint is scheduled for future removal. This endpoint is being replaced by the `customsegments` [endpoint](/dsp-api/docs/custom-audiences).

Custom audiences that can be built by providing email addresses or phone numbers.

## Hierarchy

Define an `Email Address` or `Phone Number` audience at the advertiser level.

## Endpoint

```plaintext
/traffic/audiences/email_address
```

Use the following HTTP methods:

- Use the `GET` method to read an existing email address or phone number audience.
- Use the `POST` method to create a new email address or phone number audience.
- Use the `PUT` method to update an existing email address or phone number audience.

## Resources

The following parameters are supported.

| **Field** | **Description** | **Data Type** | **Create** | **Update** |
| --- | --- | --- | --- | --- |
| `id` | Specifies the audience ID. | `integer` | N/A | Required |
| `name` | Specifies the name of the audience. | `string` | Required | Optional |
| `status` | Specifies the current status of the audience. Allowed values: - `ACTIVE`: you can target the audience. - `INACTIVE`: you cannot target the audience. Defaults to `ACTIVE` if you don’t specify a value. | `string` | Optional | Optional |
| `accountId` | Specifies the advertiser ID. An audience is tied to its advertiser and you can only use it in that advertiser’s campaigns. To learn more, refer to [Advertisers](/dsp-api/docs/advertisers). | `integer` | Required | Required |
| `retentionDays` | Specifies the number of days custom audience data is retained. Allowed values: - `30` - `60` - `90` - `180` Defaults to `180` if a value is not selected. | `integer` | Optional | Optional |
| `seedList` | Specifies an array of email addresses or phone numbers hashed using the [SHA256](https://en.wikipedia.org/wiki/SHA-2) cryptographic hashing algorithm. The limit is 50K items per request. | `array` | Required | Optional |
| `createdAt` | A read-only field that specifies when the audience was created. | `string` | N/A | N/A |

## Read Audience

Read an email address audience.

```plaintext
GET traffic/audiences/email_address/{id}?accountId={accountId}
```

### Parameters

| **Parameter** | **Parameter Type** | **Description** | **Data Type** | **Required** |
| --- | --- | --- | --- | --- |
| `id` | path | Specifies the audience ID. | `integer` | Y |
| `accountId` | query | Specifies the advertiser ID. | `integer` | Y |

### Sample Request URL

```plaintext
GET https://dspapi.admanagerplus.yahoo.com/traffic/audiences/email_address/50351924?accountId=1356341
```

### Sample Response

```plaintext
{
  "response": {
    "status": "ACTIVE",
    "id": 50351924,
    "name": "audienceTest",
    "accountId": 1356341,
    "createdAt": "2017-10-20",
    "retentionDays": 180
  },
  "errors": null,
  "timeStamp": "2017-10-20T19:04:17Z"
}
```

## Create Audience

Create a new email address or phone number audience.

```plaintext
POST /traffic/audiences/email_address
```

### Parameters

All fields are specified in the body of the `application/json` payload.

### Sample Request URL

```plaintext
POST https://dspapi.admanagerplus.yahoo.com/traffic/audiences/email_address
```

### Sample Request Body

```plaintext
{
  "name": "audience3",
  "accountId": 1356341,
  "seedList": [
    "251014dafc651f68edac7e583edab8ed4fbdbe176b9b4c81f67e9e87a66da103",
    "afbc34416ac6e7fbb97331a21fa2823f56952c0796a615d05a07a08cc52704da",
    "42cbe7eebb412bbcd5b566945df59f67962106041ae7ea39f5bc6ee99307c19e",
    "379b4653a40878da7a58458e4d9a99f834fb12179a5d4e2a840f77dc090c9a98"
  ]
}
```

### Sample Response

```plaintext
{
  "response": {
    "id": 50351924,
    "name": "audience3",
    "status": "ACTIVE",
    "accountId": 1356341,
    "createdAt": "2017-10-11",
    "retentionDays": 180
  },
  "errors": null,
  "timeStamp": "2017-10-11T00:33:54Z"
}
```

## Update Audience

Update an existing email address or phone number audience.

```plaintext
PUT /traffic/audiences/email_address/{id}
```

Partial updates are supported; values of supported fields that are not in the payload remain unchanged.

### Parameters

The audience `id` is specified in the endpoint path. All other fields are specified in the body of the `application/json` payload.

### Sample Request URL

```plaintext
PUT https://dspapi.admanagerplus.yahoo.com/traffic/audiences/email_address/50351924
```

### Sample Request Body

```plaintext
{
  "name": "audienceTest_2",
  "accountId": 1356341
}
```

### Sample Response

```plaintext
{
  "response": {
    "id": 50351924,
    "name": "audienceTest_2",
    "status": "ACTIVE",
    "accountId": 1356341,
    "createdAt": "2017-10-20",
    "retentionDays": 180
  },
  "errors": null,
  "timeStamp": "2017-10-20T19:23:53Z"
}
```

## Delete Audience

The DSP Traffic API does not support the deletion of email address or phone number audiences.