Sign in

v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
leads_export

Create a request to export leads collected from a lead ad

This feature is currently in beta and not available to all apps. If you're interested in joining the beta, please reach out to your Pinterest account manager.

Create an export of leads collected from a lead ad. This returns a leads_export_id token that you can use to download the export when it is ready.

Note: Lead ad data will be available up to 30 days after the lead has been submitted.

For more, see Lead ads.

post/ad_accounts/{ad_account_id}/leads_export

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Request body

ad_idstring required

ID for the ad collecting leads.

end_datestring required

Export leads collected on and before end date (UTC). Format: YYYY-MM-DD.

start_datestring required

Export leads collected on and after start date (UTC). Format: YYYY-MM-DD.

Example request

{
  "ad_id": "687201361754",
  "end_date": "2020-12-20",
  "start_date": "2020-12-20"
}

Response

The request has succeeded.

leads_export_idstring

ID for the leads export job.

Example response

{
  "leads_export_id": "123456789012"
}