Update measurement config

Deprecated. This page documents the v2 buyer API, which is closed to new API clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer REST integration to V3. The conversion endpoint, Log event, stays open.

PUT /api/v2/buyer/advertisers/{advertiserId}/measurement-config Updates the measurement configuration for an advertiser. This is an upsert — pass only the fields you want to change; omitted fields keep their prior values. Read the current config with Get measurement config.

Request

curl -X PUT https://api.apostra.com/api/v2/buyer/advertisers/12345/measurement-config \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mmmEnabled": true,
    "mmmConfig": {
      "provider": "example-mmm",
      "dataSourceIds": ["ds_revenue", "ds_orders"],
      "reportingFrequency": "weekly"
    },
    "brandLiftEnabled": false,
    "settings": { "defaultLookbackDays": 28 }
  }'

Parameters

Field	Type	Required	Notes
`advertiserId`	string	Yes	Path parameter — the owning advertiser
`mmmEnabled`	boolean	No	Enable Marketing Mix Modeling
`mmmConfig`	object	No	MMM settings. `provider` (string), `dataSourceIds` (string[]), `reportingFrequency` is `weekly`, `monthly`, or `quarterly`. Extra keys allowed
`brandLiftEnabled`	boolean	No	Enable brand-lift study integration
`settings`	object	No	Free-form key/value advertiser-level overrides

Response

{
  "advertiserId": "12345",
  "mmmEnabled": true,
  "mmmConfig": {
    "provider": "example-mmm",
    "dataSourceIds": ["ds_revenue", "ds_orders"],
    "reportingFrequency": "weekly"
  },
  "brandLiftEnabled": false,
  "settings": { "defaultLookbackDays": 28 },
  "isDefault": false,
  "createdAt": "2026-01-15T10:30:00Z",
  "updatedAt": "2026-03-20T14:45:00Z"
}

Returns the full config after the upsert, with isDefault: false because a config is now saved. mmmConfig is null when no MMM settings are saved; settings is null when no overrides are configured.

Errors

400 VALIDATION_ERROR — invalid reportingFrequency or malformed body.
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

Get measurement config

Read the current config

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Update measurement config

Request

Parameters

Response

Errors

Measurement tasks

Measurement overview

Get measurement config

​Request

​Parameters

​Response

​Errors

​Related

Measurement tasks

Measurement overview

Get measurement config

Request

Parameters

Response

Errors

Related