Before you start
- A Pinterest account. A free business account is recommended, because Pinterest Analytics requires one.
- Access to the Sprid account that will own this channel.
- A board topic in mind. Sprid can create the board during publishing.
You do not create a Pinterest developer app, request API access or copy a token. You only authorize your own Pinterest account.
Connect to Sprid
sprid connect pinterest --account <slug>Replace <slug> with your Sprid account slug, or use Settings → Accounts → [account] → Pinterest → Continue with Pinterest in Sprid.
Set it up
- Check the Pinterest identity in the browser that opens. Sign out first if it is the wrong account.
- Review the requested access and authorize Sprid.
- Back in Sprid, confirm the connected Pinterest name.
- Open a post, select Publish → Pinterest and pick the destination in the Board picker. If none fits, select Create board, name it and choose public or secret; Sprid selects it automatically.
Each Sprid account needs its own connect, even when several Pinterest accounts are signed in to the same browser. Check the identity every time.
Check the connection
Run sprid status and confirm Pinterest shows the intended account. Open a draft Pin, select Publish → Pinterest and confirm the intended board appears before approving any schedule.
After the first Pin publishes, open Pinterest signed out or from another account and check the Pin, board, visual, title and destination. A successful API response does not prove public visibility.
Trial and Standard access
Publishing and scheduling need Sprid’s Pinterest app to have Standard access. With Trial access you can connect and browse boards, but Sprid refuses to publish or schedule. This is Sprid’s approval, not something you apply for, and reconnecting does not change it. Keep preparing drafts, but do not treat them as booked.
Prepare the account
Create a few specific boards around topics people search for, such as “Small apartment viewing checklist” rather than “Inspiration”. Board names, descriptions and saved Pins give Pinterest context.
Claim your website in Pinterest where possible: it links Pins from that site to the profile and expands website analytics. A website can be claimed by only one Pinterest account, so decide which market or brand owns it before connecting several.
Read Pinterest content and publishing before preparing the first batch.
If something goes wrong
- “Pinterest is unavailable until API credentials and an access tier are configured”: this Sprid deployment is not ready for Pinterest. Follow Sprid’s status or contact support; you do not supply credentials.
- Wrong account connected: disconnect it in Sprid, sign out of Pinterest in that browser, then reconnect and check the identity before authorizing.
- “No Pinterest boards yet”: create one from the board picker. If Sprid asks for board permission, reconnect once; older connections lack the board write scope.
- Existing boards missing: reconnect once, then contact Sprid support with the account name and error.
- Access denied: confirm the Pinterest account is active and you finished the consent screen. Retry once, then contact Sprid support.
- Publishing or scheduling requires Standard access: see Trial and Standard access above. Boards stay selectable; only Sprid can change the tier.
- Analytics unavailable: use a business account and check the Pin is public. Unavailable data is unavailable, not zero.
Sources and verification
Prefer your terminal? sprid docs pinterest reads this same guide.