Create measurement source

POST /api/v2/buyer/advertisers/{advertiserId}/measurement-sources Registers a measurement data source (e.g. an MMM model or brand-lift study) for an advertiser. The source defines which outcome type it produces, how often, and the lag before data lands — the engine uses these to weigh incoming records and check freshness.

Request

curl -X POST https://api.interchange.io/api/v2/buyer/advertisers/12345/measurement-sources \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceKey": "acme_incr_rev",
    "name": "Acme Incrementality",
    "outcomeType": "incremental_revenue",
    "granularity": "geo_week",
    "cadence": "weekly",
    "provider": "acme-mmm",
    "lagWeeks": 1,
    "signalWeight": 1,
    "status": "active"
  }'

Parameters

Field	Type	Required	Notes
`advertiserId`	string	Yes	Path parameter — the owning advertiser
`sourceKey`	string	Yes	Stable key tying records to this source
`name`	string	Yes	Human-readable label
`outcomeType`	string	Yes	Primary outcome the source reports
`granularity`	string	Yes	Reporting grain (e.g. `geo_week`)
`cadence`	enum	Yes	`continuous`, `daily`, `weekly`, `biweekly`, `monthly`, `quarterly`
`provider`	string	Yes	Partner name (e.g. `acme-mmm`)
`outcomeTypes`	string[]	No	Additional outcome types the source reports
`lagWeeks`	integer	No	Expected reporting lag in weeks (default 1)
`ingestionMethod`	string	No	How records arrive (e.g. `api`, `sync`)
`attributionConfig`	object	No	Free-form provider attribution settings
`signalWeight`	number	No	Weight in belief updates, 0–1 (default 1)
`status`	enum	No	`pending`, `active`, `paused` (default `pending`)
`notes`	string	No	Free-text notes

Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "advertiserId": "12345",
  "sourceKey": "acme_incr_rev",
  "name": "Acme Incrementality",
  "outcomeType": "incremental_revenue",
  "outcomeTypes": [],
  "granularity": "geo_week",
  "cadence": "weekly",
  "provider": "acme-mmm",
  "lagWeeks": 1,
  "signalWeight": 1,
  "status": "active",
  "createdAt": "2026-01-15T10:30:00Z",
  "updatedAt": "2026-01-15T10:30:00Z"
}

The returned id is the sourceId you pass to Get and Update.

Errors

400 VALIDATION_ERROR — missing a required field, invalid cadence/status, or signalWeight outside 0–1.
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

List measurement sources

See registered sources

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

List measurement sources

​Request

​Parameters

​Response

​Errors

​Related

Measurement tasks

Measurement overview

List measurement sources

Request

Parameters

Response

Errors

Related