Support Pinterest Marketing API

[dl-lim]

Tell us about the new integration you’d like to have

Pinterest Marketing API as a source

┆Issue is synchronized with this Asana task by Unito

[marcosmarxm]

thanks @alderson59 I added the suggestion to the connector roadmap.

[cheyura]

Integration Vetting

Webhook-based? (no/partially/yes)
No

Available authentication modes (API key/Oauth/other)
Below are the steps to request an access_token on behalf of the authenticated user.

• Start the OAuth flow (explicit, server side)
• Receive access code upon user grant
• Exchange the code for an access token
• Access tokens and Usage

Creating an account
Self Service free
Access to the Pinterest Marketing API requires an approved App. Please follow the steps below to create an App and Apply for access.

Apply for an App
Log into Pinterest with the user ID that you’ll use to manage your developer account’s applications.
Request approval for a new app Apply for app
Work with your Pinterest contact to get your newly generated App approved.
Once approved, be sure to complete your App profile by providing
Technical Contact email - This will ensure you are Subscribed for updates.
Redirect URIs - This will ensure you can get started with User Authorization as redirect_uri is a required field for OAuth.
You will also now have access to your App ID and App secret as these are required fields for OAuth as well.

How to populate the account with data?
It can be done through the UI, API, Sandbox API.

Available streams for sync
https://developers.pinterest.com/docs/redoc/martech/#tag/Contact-Us
Streams:

• CONTENT
• ANALYTICS
• ADS
• PINNER
• SHOPPING
• AUDIENCE
• TAGS AND DOMAIN

Integration supports incremental sync?
Yes, API has pagination support , so it's possible to save cursor id for future use
Endpoints that return an object array (e.g pin object array) support the page_size and bookmark query parameters to paginate throught the results.

Other information/blockers
Request approval for a new app Apply for app
Work with your Pinterest contact to get your newly generated App approved

[cheyura]

@sherifnada

It seems like Pinterest does not accept this. Please read these constaints on the picture above

[sherifnada]

@cheyura fixed the issue. Moving out of blocked

[cheyura]

@sherifnada Pinterest ad campaign for 30 days with budget 30 USD (min daily is 1 USD) will start within 24 hours

[sherifnada]

@cheyura can we just keep it running instead of only 30 days?

[cheyura]

@cheyura can we just keep it running instead of only 30 days?

@sherifnada Yes

[lazebnyi]

Application for creating the app in Pinterest now is pending. As far as I know from the update from @cheyura the request was sent on July 8.

Original message from Pinterest:

Thank you for your interest in the Pinterest API! We're working on some updates to our program and are currently taking a pause in reviewing applications while we focus on what's next. If you'd still like to apply to our program we'll reach out to the email associated with your account once there's an update. We're excited to share with you what we've been working on.

[cheyura]

@lazebnyi app is ready