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
- Sign in with the Pinterest business account responsible for the app.
- Register an app and request Trial access.
- Once approved, open Configure and add the callback under Redirect URIs.
- 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.
| 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.
| Provider value | BYOK field |
|---|---|
| Pinterest app ID | client ID |
| app secret | client secret |
Store the secret in the app record; do not include it in a shared callback URL.
{{API_BASE_URL}}/v1/connect/pinterest/callback