# Pinterest

## Pinterest – Connector Configuration

### Step 1: Create a Pinterest Business Account & Access Developer Portal

* Create or upgrade to a Pinterest Business account at [Pinterest Business](https://business.pinterest.com/)
* Navigate to the [Pinterest Developers Portal](https://developers.pinterest.com/)
* Sign in with your Pinterest Business account credentials

> ⚠️ **Note**: You need a Pinterest Business account to access the Pinterest API. Personal accounts cannot create apps.

***

### Step 2: Create Your App

1. **Create a new app**:
   * Go to [My Apps](https://developers.pinterest.com/apps/) in the developer portal
   * Click **"Create app"**
   * Fill in the application details:
     * **App name** (e.g., "My Pinterest Integration")
     * **App description** - Describe what your integration does
     * **Website URL** - Your application's website
     * **Platform** - Select "Web" for most integrations
2. **App Configuration**:
   * **App type**: Choose between "Public" or "Internal"
   * **Linked Business Account**: Link to your Pinterest Business account
   * **App Purpose**: Specify how you'll use Pinterest data

***

### Step 3: Configure OAuth Settings

1. **Navigate to App Settings**:
   * In your app dashboard, go to **"OAuth"** or **"Settings"** section
   * Configure OAuth redirect URIs
2. **Set Redirect URIs**:
   * Add your callback URL in the **"Redirect URIs"** field
   * For Appmixer, set the redirect URI to:

```http
https://[YOUR_API_BASE]/auth/pinterest/callback
```

Example:

```http
https://api.appmixer.com/auth/pinterest/callback
```

3. **Configure Scopes**:
   * Select the permissions your app needs:
     * `read_public` - Read public boards and pins
     * `write_public` - Create public boards and pins
     * `read_secret` - Read secret boards and pins (if authorized)
     * `write_secret` - Create secret boards and pins (if authorized)
     * `read_users` - Read user profile information
     * `write_users` - Update user profile information

***

### Step 4: Copy Your Credentials

After configuring your app, you'll find your API credentials:

* **App ID** (Client ID) - Your application's unique identifier
* **App secret** (Client Secret) - Your application's secret key

⚠️ **Important**: Keep your App Secret secure and never expose it in client-side code!

***

### Step 5: App Review Process

**For Public Apps**:

1. **Submit for Review**:
   * Public apps require Pinterest review before going live
   * Provide detailed use case description
   * Include screenshots and flow documentation
   * Specify which scopes you need and why
2. **Review Requirements**:
   * Your app must comply with Pinterest's API policies
   * Demonstrate legitimate use of requested permissions
   * Show how user data will be handled responsibly

***

### Step 6: Connector Configuration

1. Go to the Appmixer BackOffice -> Configuration.
2. Add new configuration: `acme:pinterest`.
3. Add your `clientId` (App ID) and `clientSecret` (App Secret) keys with values.

   ![alt text](/files/agGvuZrjf2Tkl0aA54GA) ![alt text](/files/sMNCkTGSrmUSsCNxHA5r)

***

### Step 7: Rate Limits

**Rate Limits**:

* Pinterest implements rate limiting per user and per app
* Specific limits depend on your app's approval status and usage
* Rate limit information is included in API response headers

***

### Important Notes

⚠️ **Business Account Required**:

* Only Pinterest Business accounts can create and manage apps
* Personal accounts cannot access the Pinterest API
* Convert your personal account to business if needed

⚠️ **Content Policy**:

* Pinterest has strict content policies and community guidelines
* All programmatically created content must comply with these rules
* Violations can result in API access suspension

⚠️ **Token Management**:

* Access tokens have expiration times
* Implement proper token refresh logic
* Store tokens securely and never expose them

⚠️ **Attribution**:

* Display appropriate Pinterest branding when required
* Follow Pinterest's brand guidelines
* Include proper attribution for Pinterest content

***

### Useful Links

* [Pinterest Developers Documentation](https://developers.pinterest.com/)
* [API Reference](https://developers.pinterest.com/docs/api/v5/)
* [OAuth Guide](https://developers.pinterest.com/docs/getting-started/authentication/)
* [Rate Limits](https://developers.pinterest.com/docs/getting-started/rate-limits/)
* [Pinterest Business](https://business.pinterest.com/)
* [Community Guidelines](https://policy.pinterest.com/community-guidelines)
* [Brand Guidelines](https://business.pinterest.com/brand-guidelines/)

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.appmixer.com/connector-configuration/pinterest.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.