ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

ad_accounts

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

Changed on Jun 4, 2026

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.

post/ad_accounts/{ad_account_id}/mmm_reports

Request

Base URL
https://api.pinterest.com/v5
Auth
OAuth 2
Authorization codehttps://www.pinterest.com/oauth/
Token URLhttps://api.pinterest.com/v5/oauth/token
Scopesads: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.

Path parameters

ad_account_idstring required

Request body

advertiser_idsstring[]

Advertiser IDs for multi-advertiser report

columnsMMMReportingColumn[] required

Metric and entity columns

countriesTargetingAdvertiserCountry[]

A List of countries for filtering

custom_column_idsstring[]

List of custom column IDs

end_datestring required

Metric report end date (UTC). Format: YYYY-MM-DD

granularity'DAY' | 'WEEK' required

level'CAMPAIGN_TARGETING' | 'AD_GROUP_TARGETING' required

report_namestring required

Name of the Marketing Mix Modeling (MMM) report

start_datestring required

Metric report start date (UTC). Format: YYYY-MM-DD

targeting_typesMMMReportingTargetingType[] required

List of targeting types

Example request

{
  "columns": [
    "SPEND_IN_DOLLAR"
  ],
  "countries": [
    "US"
  ],
  "end_date": "2020-12-20",
  "start_date": "2020-12-20",
  "targeting_types": [
    "GENDER"
  ]
}

Response

The request has succeeded.

messagestring

Possible status for a bulk reporting job

sizenumber

statusstring

tokenstring

urlstring

Example response

{
  "report_status": "FINISHED",
  "status": "success"
}

Changes

Jun 4, 2026v5b698c180678a Revision changes
- breaking
  added to the request property allOf list
- breaking
  added to the request property allOf list
- breaking
  removed the enum value AD_GROUP_TARGETING of the request property
- breaking
  removed the enum value CAMPAIGN_TARGETING of the request property
- breaking
  removed the enum value DAY of the request property
- breaking
  removed the enum value WEEK of the request property
- breaking
  the request property type changed from string to no type
- breaking
  the request property type changed from string to no type
- warning
  removed subschema #1 from the request body allOf list
- warning
  changed the pattern of the request property from ^(\d{4})-(\d{2})-(\d{2})$ to ^\d{4}-\d{2}-\d{2}$
- warning
  changed the pattern of the request property from ^(\d{4})-(\d{2})-(\d{2})$ to ^\d{4}-\d{2}-\d{2}$
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new ADS_CREDIT_SPEND_IN_DOLLAR enum value to the request property /
- info
  added the new ADVERTISER_PAID_ECPC_IN_DOLLAR enum value to the request property /
- info
  added the new ADVERTISER_PAID_ECPM_IN_DOLLAR enum value to the request property /
- info
  added the new ADVERTISER_PAID_SPEND_IN_DOLLAR enum value to the request property /
- info
  added the new AUDIENCE_INCLUDE enum value to the request property /
- info
  added the new CAMPAIGN_OBJECTIVE_TYPE enum value to the request property /
- info
  added the new PINNER_LIST_NAME enum value to the request property /
- info
  added the new PLACEMENT enum value to the request property /
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the success response with the status
Feb 8, 2024v57529b464d5cb Revision changes
- info
  endpoint added

Operation history