---
title: "Upload first-party data for the specified ID for use in audience targeting."
method: POST
path: "/data/advertiser"
tags: ["Advertiser"]
---

# Upload first-party data for the specified ID for use in audience targeting.

`POST /data/advertiser`

## Headers

- `TTD-Auth` string, required

## Request body

- AdvertiserDataRequest
  - `AdvertiserId` string, required
  - `DataProviderId` string, nullable
  - `Items` AdvertiserDataItem[], nullable
    - `TDID` string, nullable
    - `DAID` string, nullable
    - `UID2` string, nullable
    - `UID2Token` string, nullable
    - `RampID` string, nullable
    - `CoreID` string, nullable
    - `EUID` string, nullable
    - `EUIDToken` string, nullable
    - `ID5` string, nullable
    - `NetID` string, nullable
    - `FirstID` string, nullable
    - `UtiqID` string, nullable
    - `MerkuryID` string, nullable
    - `RealID` string, nullable
    - `IqviaPPID` string, nullable
    - `Data` AdvertiserData[], required
      - `Name` string, required
      - `TimestampUtc` string, date-time, nullable
      - `TtlInMinutes` integer, nullable
      - `BaseBidCPM` number, double, nullable
      - `BaseBidCPMMetadata` string, nullable
      - `BidFactor` number, double, nullable
    - `CookieMappingPartnerId` string, nullable
  - `DataLoadTraceId` string, nullable

## Response `200`

Success

- AdvertiserDataServerResponse
  - `FailedLines` AdvertiserDataServerResponseLine[], nullable
    - `TDID` string, uuid, nullable
    - `DataName` string, nullable
    - `ErrorCode` 'Unknown' | 'BaseBidCPMMetadataTooLong' | 'MissingUserId' | 'UserNotMapped' | 'Deprecated_MissingCookieMappingPartnerId' | 'InvalidBidFactor' | 'DataNameTooLong' | 'InvalidTtlInMinutes' | 'InvalidBaseBidCPM' | 'InvalidDataOwnerId' | 'InvalidParameterFormat' | 'TargetingDataCreationLimitExceeded' | 'TargetingDataCountLimitExceeded' | 'TenantRestrictionsExternalData' | 'TargetingDataDisabled' | 'ItemDeserializationError'
    - `Message` string, nullable
    - `ItemNumber` string, nullable
    - `DataNumber` string, nullable

## Other responses

- `400` — Bad Request - Invalid JSON, missing items, advertiser not configured, or policy restrictions
- `401` — Unauthorized - Invalid or missing authentication token
- `403` — Forbidden - Cannot create new targeting data for this advertiser
- `413` — Request Entity Too Large - Request size exceeds the allowed limit
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error - Unexpected server error
- `503` — Service Unavailable - Handler disabled or request dropped

## Changes

- **2026-07-21** `0c55e57f52e5` — 1 info
  - added the new optional request property `Items/items/RealID`

[Change history](https://skmtc.dev/adsrvr/apis/ttd-data-api/changes/data/advertiser/post.md)

---

[API](https://skmtc.dev/adsrvr/apis/ttd-data-api.md) · [All operations](https://skmtc.dev/adsrvr/apis/ttd-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adsrvr/ttd-data-api/revisions/0c55e57f52e5/schema)