---
title: "POST /AUDIENCE/SEGMENT/"
slug: "post-audiencesegment"
updated: 2025-10-21T13:15:34Z
published: 2025-10-21T13:15:34Z
canonical: "help.yahooinc.com/post-audiencesegment"
---

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

# POST /AUDIENCE/SEGMENT/ID

Use this API to upload user qualifications for an individual taxonomy-entity {id} of type “SEGMENT”. User qualifications for a SEGMENT can also be uploaded via the recommended POST /audience API detailed in the previous section. This is an alternative way of uploading a segment. If the taxonomy id contains special characters, ensure that the HTTP client URL encodes the end point.

## Text Representation

A row (unit of data) in the payload must be a simple text value for the URN that qualifies in this segment (without any quotes or pipes or brackets etc. Just the URN, one per line).

**URN**

> [!NOTE]
> Note
> 
> 1. The user identifier URN must conform to “urnType” specified in the metadata of the POST call.
> 2. ResourceType for this representation is “datax-segment”.

## Representation Example – Upload user qualifications for segment OH224

A payload of three qualifying users with URNs 99ff2333, 07feb252 and f10d53af will look like the following prior to compression:

```plaintext
99ff2333
07feb252
f10d53af
```

## POST Call Example

Everything except the following is identical to the POST Call Example listed for /audience in the previous section:

### Sample Request URL

```http
POST /v1/audience/segment/TESTID HTTP/1.1
Host: datax.yahooapis.com
Content-Type: multipart/form-data;boundary=xyz

--xyz
Content-Type: application/json;charset=UTF-8 Content-Disposition: form-data; name="metadata"
{
        "description" : "user qualifications – daily bucket 05/19/2013",
        "extensions" : { "urnType" : "IXID" }
}
--xyz
Content-Type: application/octet-stream;charset=UTF-8
Content-Disposition: form-data; name="data"; filename="example.txt.bz2"

< bz2 compressed data >
--xyz--
```

### Sample Response

```http
HTTP/1.1 202 Accepted
Content-Type: application/json;charset=UTF-8 [Date/Timestamp]

{
        "resourceType" : "datax-audience",
        "resourceId" : "130815T013759Z662589033",
        "description" : "user qualifications – daily bucket 05/19/2013",
        "createTime" : "2013-19-05T12:19:17Z",
        "links" : [
                {
                        "rel"   : "self",
                        "href" : "https://datax.yahooapis.com/v1/link/s/mJF90HlzC0618PRm-"
                },
                {
                        "rel"   : "describes",
                        "href" : "https://datax.yahooapis.com/v1/link/5qMQo4h4c2zi-"
                }
        ],
        "status" : {
                "state" : "PROCESSING",
                "lastUpdateTime" : "2013-19-05T12:22:17Z "
        },
        "extensions" : { "urnType" : "IXID",
        "view" : "INCREMENTAL",
                "links" : [
                        {
                                "rel"   : "https://datax.yahooapis.com/rels/taxonomy",
                                "href" : "https://datax.yahooapis.com/v1/link/O3stRliZAT.G.oqiu-"
                        },
                        {
                                "rel"   : "https://datax.yahooapis.com/rels/stats",
                                "href" : "https://datax.yahooapis.com/v1/link/VJbGt6S0hiqECL_-"
                        }
                ]
        }
```