Skip to main content
Both Pinterest connections in Markifact (Pinterest Ads and Pinterest organic) can run under your own Pinterest app instead of Markifact’s. You create the app once, mint a refresh token with the scopes for the channels you use, and paste three values into Markifact.
Custom app connections are available on the Team plan. See White-label Connections for the overview.

​
What Every Pinterest Channel Needs

Pinterest access tokens expire after 30 days; Markifact refreshes them with your app ID and secret on every run. Refresh tokens last one year, after which you mint a new one and add the connection again with the same name.
Already have your own authorization flow? If your systems already hold a refresh token issued by your app with the scopes below, skip to the channel page and paste it.

​
Scopes per Channel

Request the scopes for every channel you plan to connect. One token can serve both.

​
Setting Up Your Pinterest App

1

Create the App

  1. Go to the Pinterest developer portal and click Create app
  2. Enter the app name and description. This is the branding users see when they authorize
  3. Under Redirect URIs, add a URL you control (for example https://www.youragency.com/pinterest-callback). Pinterest appends the auth code to this URL after authorization; the page does not need to do anything
  4. Copy the App ID and App secret
2

Request Standard Access

New apps start with trial access, which is rate limited and only works for the accounts that own the app. Request standard access in the portal and wait for Pinterest’s approval before connecting client accounts. Agencies that already run their own integrations will have this in place.
3

Authorize and Get the Auth Code

  1. Open the following URL in a browser, replacing the app ID, redirect URI and scopes (comma separated) for your channel:
  1. Sign in as the Pinterest user who has access to the ad accounts or boards you want to work with and click Give access
  2. Pinterest redirects to your URL with code=... in the query string. Copy the value. Auth codes expire quickly and can be exchanged once, so do the next step right away
4

Exchange the Auth Code for a Refresh Token

Run this request, replacing the values (the redirect URI must match the one used above exactly):
The response contains refresh_token. Copy it.
Important: Keep this token secure. Anyone holding it, together with your app ID and secret, can act on everything the Pinterest user can access within the granted scopes.
5

Connect in Markifact

Open the channel’s setup page from the table above, or go straight to Connections, click Connect on the channel, select the Custom App (White-label) tab, name the connection and paste the three values. Markifact refreshes the token once with your app and makes one read call before saving anything.

​
Rotating or Replacing the Token

Add the connection again with the same connection name and the new refresh token. Markifact replaces the stored credentials in place, so workflows and agents bound to the connection keep working.

​
Troubleshooting

Pinterest answers the same way for a wrong app ID or secret and for a refresh token that was issued by a different app, revoked, or expired (one year). Check the App ID and App secret on your app’s page, then mint a new refresh token with that app and add the connection again with the same name.
The token is missing a scope for the channel, or your app is still on trial access and the account is not one that owns the app. Check the scopes and the access level in the developer portal, then mint a new token.

White-label Connections

Overview of custom app connections across channels

Connections

How connections, sharing, and privacy work