---
title: "Create a request for a Marketing Mix Modeling (MMM) report"
method: POST
path: "/ad_accounts/{ad_account_id}/mmm_reports"
tags: ["ad_accounts"]
---

# Create a request for a Marketing Mix Modeling (MMM) report

`POST /ad_accounts/{ad_account_id}/mmm_reports`

## Request

- Base URL: `https://api.pinterest.com/v5`
- URL: `https://api.pinterest.com/v5/ad_accounts/{ad_account_id}/mmm_reports`
- Auth: OAuth 2
  - Authorization code: `https://www.pinterest.com/oauth/`
  - Token URL: `https://api.pinterest.com/v5/oauth/token` scopes: `ads:read`
- TypeScript: <https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/mmm_reports/post.ts> (a function with typed inputs; its response is checked against the schema)

This creates an asynchronous mmm report based on the given request.
    It returns a token that you can use to download the report when it is
    ready. NOTE: An additional limit of 5 queries per minute per advertiser
    applies to this endpoint while it's in beta release.
    For the ADVERTISER_PAID_SPEND_IN_DOLLAR,
    ADVERTISER_PAID_ECPC_IN_DOLLAR, and ADVERTISER_PAID_ECPM_IN_DOLLAR
    columns: if you receive bonus media, this value still includes that spend, and it will
    need to be removed manually with support from your Pinterest account team for a
    fully netted value. Over time, we'll also subtract bonus media and other incentives as
    data becomes available. Production and other non-media fees are excluded.

## Path parameters

- `ad_account_id` string, required

## Request body

- MMMReportCreate: Resource create operation model.
  - `advertiser_ids` string[]: Advertiser IDs for multi-advertiser report
  - `columns` MMMReportingColumn[], required: Metric and entity columns
  - `countries` TargetingAdvertiserCountry[]: A List of countries for filtering
  - `custom_column_ids` string[]: List of custom column IDs
  - `end_date` string, required: Metric report end date (UTC). Format: YYYY-MM-DD
  - `granularity` 'DAY' | 'WEEK', required
  - `level` 'CAMPAIGN_TARGETING' | 'AD_GROUP_TARGETING', required
  - `report_name` string, required: Name of the Marketing Mix Modeling (MMM) report
  - `start_date` string, required: Metric report start date (UTC). Format: YYYY-MM-DD
  - `targeting_types` MMMReportingTargetingType[], required: List of targeting types

## Response `200`

The request has succeeded.

- MMMReport
  - `message` string
  - `report_status` 'DOES_NOT_EXIST' | 'FINISHED' | 'IN_PROGRESS' | 'EXPIRED' | 'FAILED' | 'CANCELLED': Possible status for a bulk reporting job
  - `size` number
  - `status` string
  - `token` string
  - `url` string

## Other responses

- `201`: Resource create operation completed successfully.
- `400`: The request could not be understood by the server due to unexpected data.
- `401`: Authentication is required and has either failed or not been provided.
- `403`: The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404`: The requested resource could not be found on this server.
- `429`: The user has sent too many requests in a given amount of time and is being rate limited.
- `default`: An unexpected error response.

## Changes

- **2026-06-04** (v5) `b698c180678a`: 8 breaking, 5 warning, 22 info
  - added `#/components/schemas/MMMReportGranularity` to the `granularity` request property `allOf` list
  - added `#/components/schemas/MMMReportLevel` to the `level` request property `allOf` list
  - removed the enum value `AD_GROUP_TARGETING` of the request property `level`
  - removed the enum value `CAMPAIGN_TARGETING` of the request property `level`
  - …31 more
- **2024-02-08** (v5) `7529b464d5cb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/ad_accounts/:ad_account_id/mmm_reports/post.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pinterest/apis/pinterest-rest-api/revisions/b698c180678a?raw)