Skip to content

Pinterest developer app setup

Pinterest developer app setup begins with the provider application. Use the Pinterest business account administering your app to register it, obtain Trial access, and configure the exact OAuth redirect URI.

Callback URL

Register {{API_BASE_URL}}/v1/connect/pinterest/callback in the provider’s OAuth redirect settings. Configure the API origin for your environment and keep the callback path unchanged.

Configure Pinterest

  1. Sign in with the Pinterest business account responsible for the app.
  2. Register an app and request Trial access.
  3. Once approved, open Configure and add the callback under Redirect URIs.
  4. Copy the app ID and app secret.

Permissions and access restrictions

Use the permission identifiers listed in the table. Pinterest requires an exact redirect-URL match. Check the configured origin and the unchanged callback path if authorization reports a redirect mismatch.

Save the app before connecting an account

Open Integrations → Apps (BYOK) → New app and select Pinterest. Fill the client ID and client secret fields using the credential map, then save the app record. Begin a new integration, pick that saved app, and only then choose Pinterest for account authorization. Selecting the app first binds the connection to the intended credentials.

Requested permission identifiers
Permission
boards:read
boards:write
pins:read
pins:write
user_accounts:read

Request only the capabilities your product uses and complete the provider’s review requirements.

Credential field map
Provider valueBYOK field
Pinterest app IDclient ID
app secretclient secret

Store the secret in the app record; do not include it in a shared callback URL.

OAuth callback URL
{{API_BASE_URL}}/v1/connect/pinterest/callback