Knowledge Base

API Reference Documentation for Sending a dataset using The Trade Desk Connector

Below is the reference documentation for sending (or syncing) a dataset to The Trade Desk via Narrative’s Connections endpoint. For more information on the Narrative API, visit api.narrative.io.

Endpoint

POST https://app.narrative.io/connections

Request Body

{
    "dataset_id": 1234,
    "profile_id": "d1de5d3f-9f31...",
    "quick_settings": {
        "advertiser_ids": [
            "my_advertiser_id"
        ],
        "data_segment_names": [
            "my_data_segment_name"
        ],
        "first_party_data_type": "first_party_external",
        "historical_data_enabled": true
    }
}

dataset_id: The numeric identifier of your dataset in Narrative.
profile_id: The Trade Desk Connector profile ID you created (truncated).
quick_settings:
- advertiser_ids: One or more advertiser IDs in The Trade Desk.
- data_segment_names: The names of the data segments (aka audiences) you want to create or update.
- first_party_data_type: Set to first_party_external for external uploads.
- historical_data_enabled: When true, includes historical matches from your dataset.

Response

Status Code: 201 Created

{
    "id": "f7974235-2d27...",
    "dataset_id": 1234,
    "quick_settings": {
        "advertiser_ids": [
            "my_advertiser_id"
        ],
        "data_segment_names": [
            "my_data_segment_name"
        ],
        "first_party_data_type": "first_party_external",
        "historical_data_enabled": true
    },
    "profile_id": "d1de5d3f-9f31...",
    "status": "active"
}