Connect Pinterest to PostOnce: Boards, Permissions & Fixing Connection Errors

This is the practical guide to getting Pinterest connected to PostOnce and keeping it connected. If you just want to know how to schedule once you're set up, see how to schedule Pinterest pins. This page is about the connection itself — the boards you need, the permissions PostOnce asks for and why, and the errors people actually hit.

What you need before you connect

Pinterest only lets approved tools publish on your behalf once a couple of things are in place. Check these first and the connection takes about two minutes:

• A business account. Pinterest's publishing API is built for business accounts. Converting is free — in Pinterest, go to Settings → Account management → Convert to a business account. You keep your existing pins and followers.
• At least one board. Every pin has to go to a board, so you need somewhere to pin to. If your account has no boards yet, create one in Pinterest before you connect — you'll choose the destination board when you schedule a pin.
• You're the owner or admin of the Pinterest account you want to connect.

If you manage Pinterest for a client, make sure you have proper account access — not a shared login that can be revoked — or the connection may drop when their session changes.

What permissions PostOnce asks for (and why)

When you connect, Pinterest shows you a consent screen. PostOnce requests only what it needs to publish your pins and show your account in your dashboard:

• boards:read — list your boards so you can choose where each pin goes when you schedule it.
• boards:write — create or manage boards on your behalf if you need a new destination.
• pins:read — read your pins so PostOnce can confirm a scheduled pin actually published.
• pins:write — publish the pins you schedule, at the time you schedule them.
• user_accounts:read — read your account name and avatar so the right account shows up in your dashboard.

That's it. PostOnce does not request access to your messages, your followers' personal data, or your private audience analytics beyond what's needed to confirm a pin went live. If you toggle any of these off on the consent screen, publishing will fail later — leave them all enabled.

How to connect Pinterest, step by step

1. Log in to PostOnce and open your dashboard.
2. Click Connect Account and choose Pinterest.
3. You'll be redirected to Pinterest to sign in. Use the login for the business account you want to connect.
4. On the permissions screen, leave all requested permissions enabled — if you toggle any off, publishing will fail later.
5. Confirm it's the correct account.
6. Click Authorise. You'll land back in PostOnce with Pinterest connected and ready to schedule.

Common Pinterest connection errors and how to fix them

These are the issues people hit most often, with the actual fix rather than a generic "try again".

"No boards found"

PostOnce connected fine, but your account has no boards to pin to. Pins always go to a board, so there's nowhere to send them. Create at least one board in Pinterest, then reconnect — or refresh the connection in PostOnce — so the new board appears in the destination list.

A pin fails to publish

This almost always means a permission was unticked on the consent screen, or no destination board was selected when scheduling. PostOnce needs every requested permission to publish. Disconnect Pinterest in your PostOnce settings, reconnect and accept all permissions, then make sure you pick a destination board when you schedule the pin.

"Session expired" or pins suddenly stop publishing

Pinterest access tokens expire periodically. When that happens, PostOnce flags the account as needing reconnection. Go to Settings → Integrations, click Reconnect on Pinterest, and re-authorise. Nothing in your schedule is lost — queued pins resume publishing once you're reconnected.

Connection works, but the wrong account appears

If you have access to more than one Pinterest account, it's easy to authorise with the wrong one. Disconnect, reconnect, and watch the sign-in step carefully — log in as the specific business account you want to publish to, then reselect it.

API or permission errors

If you see a generic API or permission error, the usual cause is that the account isn't a business account, or a scope was declined. Convert to a business account in Pinterest settings if you haven't already, then disconnect and reconnect, accepting all scopes when prompted.

Keeping Pinterest connected

Pinterest tokens are reliable but not permanent. To avoid surprise gaps:

• Reconnect promptly whenever PostOnce flags Pinterest as disconnected.
• Keep at least one board available as a destination so scheduled pins always have somewhere to go.
• Don't revoke PostOnce in your Pinterest connected-apps settings unless you intend to disconnect.

Once connected, you're ready to schedule Pinterest pins — and to publish the same content to Instagram, Facebook, and the rest from a single composer.