API Credentials for Pinterest
Guide to obtaining tokens, keys, and connections.
Step-by-step guide to create your app on Pinterest, get your “Client ID” and “Client Secret,” and connect your account in Botize. By following the steps in order, you’ll end up with Pinterest connected (first in Sandbox/Trial mode) and know how to request Production (Standard) access.
Create and approve your application on Pinterest
-
1
Go to https://developers.pinterest.com (Pinterest’s developer platform).
-
2
Click on “My Apps.” Pinterest works through “apps” — each connection is an app.
-
3
Click the “Connect app” button to create a new one.
-
4
Fill out the form: upload a logo (any image works, it won’t affect the result), give your app a name (for example, “Botize” or whatever you prefer), and fill in your company name, website, and privacy policy link.
-
5
In the app description, you can write something like “process automation.”
-
6
Select “I’m developing an app for my organization/personal use.”
-
7
Under “Use cases,” choose “Creation and scheduling of Pins.”
-
8
Under “Audience,” select “Pinterest users.”
-
9
Check the captcha and click “Submit.”
-
10
Wait a few minutes for an email from Pinterest confirming your app has been approved. Open the email and click the button inside.
-
11
After clicking, you’ll be taken to Pinterest’s website where you’ll see a card for your app with the status “Active Trial Access.” In this mode, Pins you publish won’t be public yet.
Get your Client ID
-
1
On your app card in Pinterest, click the “Manage” button.
-
2
Inside the app management page, find the “App ID.” That’s your “Client ID.” Copy it.
Get your Client Secret
-
1
On the same app management page, find the “App secret key.”
-
2
Click the button to reveal/copy the key. That’s your “Client Secret.” Copy it and keep it safe.
Set up and connect in Botize (Sandbox / Trial)
-
1
Log in to Botize and go to “Applications.”
-
2
Search for “Pinterest” and open it.
-
3
Click “Add a new profile.” You’ll see three fields to fill in to connect Botize with Pinterest.
-
4
Paste the “Client ID” you copied from Pinterest into the “Client ID” field.
-
5
Paste the “Client Secret” from Pinterest into the “Client Secret” field.
-
6
In the “Redirect URI” field, type exactly (in lowercase): https://botize.com/callback/pinterest and click “Add.”
-
7
In the environment dropdown, select “Sandbox” (this corresponds to Pinterest’s Trial mode).
-
8
Click “Connect.” A Pinterest window will open showing a “Grant access” button. Click “Grant access.”
-
9
After a few seconds, you’ll be redirected back to Botize. You’ll see that your Pinterest account is now connected and ready to automate tasks (in Trial mode: Pins won’t be public yet).
Request Standard (Production) access in Pinterest
-
1
Go back to your app card at developers.pinterest.com and click the “Upgrade” button.
-
2
Pinterest will ask you for a video showing: (a) how you log in to your app from Botize (the “Connect” step you did before) and (b) how you’re going to use Pinterest (a real automation posting Pins).
-
3
Create your first automation in Botize that publishes a Pin and confirm it works. Record a video showing both steps (login and posting).
-
4
Attach the video in the Pinterest form and submit it to request “Standard” (Production) access.
-
5
Once Pinterest approves you, return to Botize and reconnect your Pinterest account, this time selecting “Production” in the environment dropdown.