Overview

This guide explains how to correctly register your Pinterest App, configure it with Boomi Data Integration, and resolve common authorization errors.

note

To connect Pinterest to Boomi successfully, you must register a Pinterest App on the Pinterest Developer Platform.
Without this step, you may see an error such as:

Error: [RVR-ERR-001] 403 Not Authorized – "User is not authorized to CreateWorkload on this entity workloads for clientType ADS_API"

Step 1: Create a Pinterest developer app

1. Log in to your Pinterest Business Account.
2. Navigate to the Pinterest Developer Dashboard and click Create App. For more information, refer to the Pinterest documentation.
3. Verify the following fields:

   Field	Description
   App Name	Choose a descriptive name. For example, Boomi - Pinterest Integration
   Description	For example, Integration between Pinterest Ads and Boomi for analytics.
   Redirect URI	https://auth.rivery.io/oauth/callback
   Privacy Policy URL	https://rivery.io/privacy-policy/

Step 2: Verify access permissions

For more information, refer to Pinterest documentation.

Check the following requirements:

Requirement	Details
Account Type	Must be a Pinterest Business Account
User Role	Must have at least one of the following: Owner, Admin, Analyst, or Campaign Manager
App Access Tier	For production ads analytics, ensure your app has Standard access (not Trial)
Scope	Must include the ads:read permission for analytics data

If your app is in Trial mode, request an upgrade to Standard through the Pinterest developer portal.

Step 3: Test the connection

1. Go back to your Boomi – Pinterest connection.
2. Click Connect with Pinterest to trigger the OAuth flow.
3. Click Test Connection – it should now display Connection Successful.
4. Try running Auto-Mapping again.

If configured correctly, the mapping process will complete without authorization errors.

Common errors and solutions

Error	Cause	Solution
403 not authorized	App not registered or missing ads scopes	Register the app and include ads:read scope
redirect_uri mismatch	Redirect URI in Pinterest app doesn’t match Boomi callback	Copy Boomi’s callback URL exactly
User is not authorized to CreateWorkload…	Insufficient ad account permissions	Ensure Pinterest user is Owner/Admin/Analyst/Campaign Manager
invalid_client	Wrong Client ID or Secret	Double-check credentials from Pinterest Developer App