> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update measurement config

> Enable measurement features and set MMM options for an advertiser

`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](/v2/buyer/measurement/tasks/get-measurement-config).

## Request

<CodeGroup>
  ```bash curl theme={null}
  curl -X PUT https://api.interchange.io/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"
      },
      "incrementalityTestingEnabled": true,
      "brandLiftEnabled": false,
      "settings": { "defaultLookbackDays": 28 }
    }'
  ```
</CodeGroup>

## 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 |
| `incrementalityTestingEnabled` | boolean | No       | Enable A/B incrementality tests                                                                                                                 |
| `brandLiftEnabled`             | boolean | No       | Enable brand-lift study integration                                                                                                             |
| `settings`                     | object  | No       | Free-form key/value advertiser-level overrides                                                                                                  |

## Response

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

Returns the full config after the upsert. `mmmConfig` is `null` when `mmmEnabled` is `false`; `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](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Measurement tasks" href="/v2/buyer/measurement/tasks" icon="list-check">
    All measurement operations
  </Card>

  <Card title="Measurement overview" href="/v2/guides/measurement-incrementality" icon="chart-line">
    Pipeline, belief state, and concepts
  </Card>

  <Card title="Get measurement config" href="/v2/buyer/measurement/tasks/get-measurement-config" icon="magnifying-glass">
    Read the current config
  </Card>
</CardGroup>