Skip to main content

Pinterest — Authentication

B
Written by Ben Keeling

A plain-language overview of the access we request, what each permission lets us do, who on your team should connect, and what to expect during setup.



​

Pinterest or Pinterest Ads?

Medialake has two separate Pinterest integrations:

  • Pinterest (this page) syncs your organic content: the boards on a Pinterest account and the Pins saved to them, with each Pin's comment and reaction counts.

  • Pinterest Ads syncs your advertising data: ad accounts, campaigns, ad groups and ads, the Pins behind those ads, and paid performance metrics such as spend. See Pinterest Ads — Authentication.

They are connected separately, request different permissions, and each has its own access keys and redirect URI. You can use either or both.


​

What to expect

Connecting takes a couple of minutes. When you connect Pinterest in Medialake, you're redirected to the official Pinterest login page, then to Pinterest's consent screen describing the access being requested, all of it read-only and explained in the table below. You approve it yourself and can revoke access at any time. We never see or store your password: the login happens entirely on pinterest.com, and once you approve you're returned to Medialake.

We follow the principle of least privilege: we only request the access the work needs. We never create, edit, or delete Pins or boards. Account, board and Pin details are read through Pinterest's official API v5; video files are downloaded from each Pin's page on pinterest.com.

 You                    Medialake                 Pinterest
  │  connect source         │                         │
  │────────────────────────▶│                         │
  │  redirect to Pinterest  │                         │
  │◀────────────────────────│                         │
  │  log in & grant access  │                         │
  │──────────────────────────────────────────────────▶│
  │  redirect with code     │                         │
  │◀──────────────────────────────────────────────────│
  │                         │  exchange code          │
  │                         │────────────────────────▶│
  │                         │  access + refresh token │
  │                         │◀────────────────────────│
  │  source authorized      │                         │
  │◀────────────────────────│                         │
  │                         │  renews automatically   │
  │                         │────────────────────────▶│


​

Two ways to connect

Pinterest can be connected through Medialake's OAuth app or through your own OAuth app:

  1. Medialake's OAuth app (default). Accounts connect using Medialake's central Pinterest app. No setup is required: just sign in and approve.

  2. Your own OAuth app (optional). If your organization would rather own the app that appears on the consent screen, you can create an app in your own Pinterest developer account and add its credentials to Medialake. Your organization owns the app and can disable it at any time. Setup steps are below.

The permissions requested, and everything else on this page, are identical for both options.


​

Setting up your own OAuth app (optional)

Most organizations connect with Medialake's app and can skip this section. If you do want to use your own app, you'll need access to the Pinterest developer portal for your business.

  1. In the Pinterest developer portal, create an app for your business.

  2. Make sure the app can request the five scopes in the permissions table below. Medialake needs no others.

  3. Register this redirect URI on the app. Pinterest requires it to match exactly:

https://oauth2.medialakeapp.com/pinterest-redirect
  1. Copy the app's ID and secret key. Medialake calls these the Client ID and Client Secret.

>Keep the Client Secret private. Store it in an approved password manager or secret-management system. Do not email it, paste it into a support ticket, or commit it to source control.

If you also use your own app for Pinterest Ads, note that Pinterest Ads uses a different redirect URI. Its access key is added on the Pinterest Ads integration, not this one.


​

Adding the credentials to Medialake

You need Medialake administrator privileges for these steps.

  1. Open Administration → Integrations from the sidebar.

  2. Open the Pinterest integration.

  3. In the Access Keys section, click Create New Setting.

  4. In the New access key panel, give the key a Name your team will recognize, such as "Marketing Pinterest app".

  5. Under Credentials, enter the app ID in Pinterest Client ID and the secret key in Pinterest Client Secret. Medialake stores these encrypted and never shows them again.

  6. Under Who can use it?, choose which teams can connect Pinterest accounts with this key.

  7. Click Save access key.


​

Verifying it's really us

On Pinterest's consent screen, check that the app requesting access is the one you expect: Medialake's Pinterest app, or the app your organization created and named. If the name doesn't match, stop and contact us. Never approve a Pinterest access request you weren't expecting.


​

Who should do the connecting

The connection is tied to the Pinterest account that signs in, and Medialake syncs that account's boards. Please have it done by someone who:

  1. Can sign in to the Pinterest account whose boards you want to sync. One connection covers one Pinterest account; to sync several accounts, connect each one separately.

  2. Is a permanent member of your team. If the person who authorized us leaves your company, someone else who can log in to the Pinterest account may need to reconnect.

The only account details we read are the account's business name or username, account ID, and profile image, to confirm who authorized.


​

Limiting what Medialake can access

Medialake can only reach the boards and Pins the connected account can reach, enforced by Pinterest on every request. Within that, you decide which boards are synced, and boards you don't select aren't read beyond being listed.


​

Connect and choose what to sync

Anyone on your team who is allowed to connect sources can do this.

  1. Open Connections → Catalogue from the side menu.

  2. Find Pinterest and click Connect.

  3. Under How do you want to connect?, choose Connect it myself. If your organization has saved its own Pinterest app as an access key, an OAuth app dropdown appears: choose your app, or leave it on Medialake's OAuth app.

  4. Log in to Pinterest and approve the request.

  5. Back in Medialake, choose which boards to sync.

For each board you select, Medialake brings in:

  • Every Pin's image or video. Images come in at the highest resolution Pinterest provides. Carousel Pins are split into one file per slide, and each video's cover image is brought in too.

  • Each Pin's audience and promotion status, based on the board's privacy setting and whether the Pin has been promoted. See Organic Post Availability and Visibility.

  • Each Pin's comment and reaction totals. See the Performance Metrics Reference for how organic metrics are captured.

By default Medialake checks for new Pins once a day; you can change the schedule under Source Synchronization on the source's General tab.


​

The permissions we request

Permission (scope)

What it lets us do

How we use it

user_accounts:read

See user accounts and followers.

READ ONLY: reads the business name or username, account ID, and profile image of the account connecting, to confirm who authorized

boards:read

See public boards, including group boards.

READ ONLY: lists your boards so you can choose what to sync, and reads each board's privacy setting

boards:read_secret

See secret boards.

READ ONLY: so secret boards are covered as well as public ones

pins:read

See public Pins.

READ ONLY: reads the Pins on the boards you select, their images and videos, and their comment and reaction totals. This is what becomes a media file in Medialake

pins:read_secret

See secret Pins.

READ ONLY: so Pins on secret boards are read as well as public ones

Every scope is read-only. Pinterest also offers write scopes, such as pins:write and boards:write, for creating and changing content. We never request them. This integration also doesn't request ads:read; advertising data comes through the separate Pinterest Ads integration.


​

What we can't see or do

Regardless of who connects, we cannot:

  • See or store your password, or log in as you

  • Create, edit, move, or delete Pins or boards

  • Follow, message, or comment on your behalf

  • See advertising data such as campaigns, ads, or spend


​

Staying connected

Pinterest access tokens last 30 days. When you connect, Pinterest also issues a refresh token. When an access token expires, Medialake uses the refresh token to get a new one in the background, and Pinterest issues a fresh refresh token each time, valid for 60 days. As long as the source keeps syncing, the connection renews itself indefinitely and there's nothing to re-approve on a schedule. If a refresh token is ever close to running out, Medialake shows a warning on the source 48 hours before it expires.

The connection stops working if access is revoked on Pinterest or a renewal is refused. When that happens, Medialake stops syncing the source and shows a Service Disconnected notice on it. The person who connected it can click Re-Authenticate to log in again, or Check connection if they think it was disconnected by mistake. Other team members see who to contact.


​

Revoking access

You're in control at any time. To remove the connection:

  • On Pinterest, logged in as the connecting account, open your settings and remove Medialake from the apps you've given access to, or

  • Delete the source in Medialake: open it and, on its General tab, click Delete Service.

Revoking on Pinterest's side invalidates the tokens and data collection stops; no action is needed on our side.


​

Troubleshooting

What you see

Likely cause

What to do

A board you expected isn't listed

It isn't on the Pinterest account that connected.

Connect Pinterest as the account that has the board.

You see boards and Pins but were expecting campaigns and spend

This is the organic Pinterest integration.

Connect Pinterest Ads instead. See Pinterest Ads — Authentication.

Some Pins have media but no comment or reaction totals

Pinterest doesn't return lifetime totals for every Pin. For example, Pins created before March 20, 2023 only have them if they're video or Idea Pins.

Nothing to fix.

Pinterest shows an error instead of its consent screen (your own app only)

The redirect URI registered on the app doesn't exactly match https://oauth2.medialakeapp.com/pinterest-redirect, or the app can't request one of the scopes above.

Correct the app's settings in the Pinterest developer portal, or connect with Medialake's OAuth app instead.

You're returned to Medialake with an error and no source is created

The login was cancelled, or Pinterest refused the code exchange, often because the Client Secret in the access key is wrong or has been regenerated.

Try again. If you use your own app, create a new access key with the current app ID and secret key.

The source shows Service Disconnected

Access was revoked on Pinterest, or the refresh token expired because the source went more than 60 days without renewing.

Click Re-Authenticate on the source.

If you get stuck, contact [email protected] and we'll walk you through it.


​

Further reading (Pinterest documentation)


You can review or withdraw access at any time from your Pinterest account settings.

Did this answer your question?