Pinterest — Connect it to MokonyxSocial

This guide walks you through connecting Pinterest so MokonyxSocial can publish your Joomla content as a Pin — an image with a title, description, and destination link — on one of your boards. Just remember that every Pin needs an image, so content without a usable image (like the article's Open Graph image) can't be pinned.

What you need

• A Pinterest business account. Personal accounts can't create Pins through the API.
• A board to pin to.
• A Pinterest app in the developer portal, plus an OAuth access token that carries the pins:write and boards:read scopes.

Get your credentials

Access token access_token (required)

This is an OAuth 2.0 access token that lets MokonyxSocial create Pins on your behalf. It needs to include the boards:read and pins:write scopes (add pins:read too if you'd like the test to read your new Pin back).

Here's how to get one:

1. If your account isn't already a business account, convert it (it's free): https://www.pinterest.com/business/convert/.
2. Head to the Pinterest Developer portal at https://developers.pinterest.com → My apps → Connect app to register an app. Fill in the name and details and accept the terms.
3. In the app, note your App ID and App secret, and add a Redirect URI in the settings — OAuth requires one.
4. Request the boards:read, pins:read, and pins:write scopes for the app.
5. Generate a token. For a single account, the fastest route is the portal's built-in "Generate token" tool on the app page. Otherwise, complete the OAuth flow (authorize, then exchange the returned code for a token at https://api.pinterest.com/v5/oauth/token). Note that brand-new apps start in trial/sandbox mode — to create real Pins on the live API, you may need to apply for standard access in the app's review section.
6. Copy the access token and paste it into the access_token field.

Access tokens expire (usually after about 30 days), so when posting starts failing with an auth error, regenerate the token and update this field.

Set it up in MokonyxSocial

1. In Joomla admin, go to Components → MokonyxSocial → Services → New.
2. Choose Pinterest.
3. Enter your access_token.
4. Click Send Test to verify, then Save & Close and make sure it's Published.

Verify

Open your Pinterest profile, go to the target board, and confirm your test Pin is there with its image, title, and link. Your own new Pins usually show up right away.

Troubleshooting

• "401 Unauthorized" or invalid token — your token expired or was revoked. Regenerate it in the developer portal and update the field.
• "403" or insufficient scope — your token is missing pins:write (or boards:read). Recreate it with the right scopes.
• "Image required" or the Pin won't create — the content has no usable image, and Pins can't exist without one. Make sure the article has an Open Graph or featured image.
• Works in test but not live ("trial access") — your app is still in sandbox mode. Apply for standard API access in the Pinterest portal.

Notes & limits

• Only business accounts can create Pins through the API.
• The API has rate limits per app and per user, so rapid bulk pinning may get throttled.
• Titles and descriptions have length caps (title around 100 characters, description around 500); longer text gets trimmed.
• Every Pin needs both an image and a destination link — Pinterest is image-first by design.