Custom Pinterest App

Markifact supports two ways to connect Pinterest: using the built-in Markifact app (Quick Connect) or connecting through your own Pinterest app (Custom App). With a custom app, every request Markifact makes runs under your app in the account’s connected apps, so your clients never see Markifact.

Custom app connections are available on the Team plan. See White-label Connections for the overview.

What You Need

Item	Value
App ID and App Secret	From your app’s page in the Pinterest developer portal
Refresh Token	Minted against that app with the scopes below
Scopes	`pins:read`, `pins:write`, `pins:read_secret`, `pins:write_secret`, `boards:read`, `boards:write`, `boards:read_secret`, `boards:write_secret`, `user_accounts:read`
Pinterest user for the token	the Pinterest account whose boards you want to publish to and report on

Create the app and mint the refresh token

The Pinterest setup (app, standard access, authorization URL, code exchange) is the same for both Pinterest channels and lives on one page.

Connect to Markifact

Open the Custom App tab

Go to the Connections page, click Connect on Pinterest, and select the Custom App (White-label) tab.

Name the connection

Enter a Connection Name (for example “Acme Agency Pinterest”). This is how the connection appears in nodes, agents, and MCP.

Paste your credentials

Paste the App ID, App Secret, and Refresh Token from your Pinterest app.

Verify & Connect

Markifact refreshes the token once with your app, then makes one call that reads the account’s username. Nothing is saved unless both succeed.

Custom app connections show a Custom app badge on the Connections page and work everywhere a Quick Connect connection works.

Rotating or Replacing the Token

Add the connection again with the same connection name and the new refresh token. Markifact replaces the stored credentials in place, so workflows and agents bound to the connection keep working.

Troubleshooting

Pinterest returned no username for this token

The token was minted without the user_accounts:read scope. Include it when authorizing and mint a new token.

App, token or scope errors

See the shared Custom Pinterest App troubleshooting for authentication failures, missing scopes and trial access limits.