Upload context records

POST /api/v2/buyer/advertisers/{advertiserId}/context-records Uploads exogenous context data — promos, weather, competitor activity, seasonality — so the learning engine can partial these effects out when estimating incremental impact. Each record covers one geo and time window. Up to 5,000 records per call.

Request

curl -X POST https://api.interchange.io/api/v2/buyer/advertisers/12345/context-records \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {
        "geo": "US-CA",
        "timeWindowStart": "2026-03-01",
        "timeWindowEnd": "2026-03-07",
        "promoActive": true,
        "promoType": "site_wide_15_off",
        "seasonalityIndex": 1.12,
        "flightStatus": "active"
      }
    ]
  }'

Parameters

Field	Type	Required	Notes
`advertiserId`	string	Yes	Path parameter — the owning advertiser
`records`	array	Yes	1–5000 records
`records[].geo`	string	Yes	Geo identifier (e.g. `US-CA`)
`records[].timeWindowStart`	string	Yes	Date `YYYY-MM-DD`
`records[].timeWindowEnd`	string	Yes	Date `YYYY-MM-DD`
`records[].promoActive`	boolean	No	Whether a promo ran (default `false`)
`records[].promoType`	string	No	Free-text promo descriptor
`records[].temperatureAvg`	number	No	Average temperature for weather effects
`records[].competitorActivity`	object	No	Free-form competitor signals
`records[].seasonalityIndex`	number	No	Seasonality multiplier
`records[].flightStatus`	enum	No	`active`, `dark`, `pre_flight`, `post_flight` (default `active`)

Response

{
  "recordsUploaded": 1
}

Returns the count of records uploaded. The endpoint upserts on (account, advertiser, geo, time window), so re-uploading the same key updates in place.

Errors

400 VALIDATION_ERROR — empty records, more than 5,000 records, a missing required field, or a malformed date.
404 NOT_FOUND — advertiserId does not exist or is not visible to the authenticated account.

See Errors for the full error contract.

Measurement tasks

All measurement operations

Measurement overview

Pipeline, belief state, and concepts

Upload measurement records

Upload outcome records

Update test cohort Upload measurement records

⌘I

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Request

Parameters

Response

Errors

Measurement tasks

Measurement overview

Upload measurement records

​Request

​Parameters

​Response

​Errors

​Related

Measurement tasks

Measurement overview

Upload measurement records

Request

Parameters

Response

Errors

Related