## Pinterest integration

Pinterest is a visual discovery platform that lets users find and save ideas through images and videos organized into boards. Integrating Pinterest with Frontegg allows your application to read and manage boards, pins, and user account data on behalf of your users through OAuth 2.0 authentication.

Prerequisites
- A Pinterest account with developer access
- Access to the [Pinterest Developer Platform](https://developers.pinterest.com/)


### Connect Pinterest

#### Step 1: Open the developer portal

Navigate to [developers.pinterest.com/apps](https://developers.pinterest.com/apps/) and sign in with your Pinterest account. The **My apps** page lists all applications connected to your account.

Click **Connect app** to register a new application.

![Pinterest developer portal My apps page](/assets/pinterest-1.1e6fbfb60828e0d0e1806d5c34a1d30f3a41e8ebe3d043119b3b1f9d22c2b88c.1ce25488.png)

#### Step 2: Fill in the app registration form

Complete the **Connect App** form with the following required fields:

- **App name** -- Enter a descriptive name (e.g., "Frontegg Integration"). The name must not contain the word "Pinterest".
- **Company name** -- Your company or organization name.
- **Company website or App link** -- Your company's website URL.
- **Link to Privacy policy** -- A URL to your privacy policy.
- **App purpose** -- A description of what your app will do.
- **Use cases** -- Select the use cases that apply (e.g., "Reporting", "Pinner App").
- **Audience** -- Select the intended audience (e.g., "Pinners", "Creators").


Complete the reCAPTCHA and click **Submit connect request**.

![Pinterest app registration form](/assets/pinterest-2.78a60941903a5cab1246f476c4825a673d8729abe2df24dc2af1a2397ac660e6.1ce25488.png)

#### Step 3: Copy your app credentials

After your app is created, open it from the **My apps** page and scroll to the **API keys** section. Here you will find:

- **App id** -- Your application's unique identifier (equivalent to Client ID).
- **App secret key** -- Your application's secret (equivalent to Client Secret). Click **Show app secret key** to reveal it.


Copy both values and store them securely. The app secret key should be treated as a password.

Keep your credentials secure
Never share or commit your app secret key to version control.

![Pinterest API keys section](/assets/pinterest-3.ef9153cac25f178ee1b2d4b19c40f0ac268fc7e25de268eed74009484964629d.1ce25488.png)

#### Step 4: Configure redirect URIs

Scroll to the **Redirect URIs** section. Enter the following redirect URIs in the input field, adding each one separately:

- `https://YOUR_MCP_GATEWAY_URL/integration-callback`


Press **Enter** or click **Add redirect link** to save the URI.

![Pinterest redirect URIs configuration](/assets/pinterest-4.fe132453401de1755b0dcf41d60040a1d2ef69fb9989983b21af6d98e66db292.1ce25488.png)

#### Step 5: Review API scopes

Scroll to the **API scopes** section to see the available permissions for your app. Pinterest grants scopes at the account level based on your app's access tier.

The following scopes are available and used by the integration:

| Scope | Description |
|  --- | --- |
| `user_accounts:read` | See user account information |
| `boards:read` | See public boards and group boards |
| `boards:write` | Create, update, or delete public boards |
| `boards:read_secret` | See secret boards |
| `boards:write_secret` | Create, update, or delete secret boards |
| `pins:read` | See public pins |
| `pins:write` | Create, update, or delete public pins |
| `pins:read_secret` | See secret pins |
| `pins:write_secret` | Create, update, or delete secret pins |
| `ads:read` | See advertising data (ads, ad groups, campaigns) |
| `ads:write` | Create, update, or delete ads |
| `catalogs:read` | See catalog data |
| `catalogs:write` | Create, update, or delete catalogs |
| `billing:read` | See billing data |
| `billing:write` | Create, update, or delete billing data |
| `biz_access:read` | See business access data |
| `biz_access:write` | Create, update, or delete business access data |


Minimum required scopes
For basic functionality, you need: `user_accounts:read`, `boards:read`, `pins:read`.

Trial access limitations
New apps start with **Trial access**, which limits pins created through the API to be visible only to the authenticated user. To remove this restriction and access higher rate limits, apply for **Standard access** by clicking **Upgrade access** on the app page.

![Pinterest API scopes overview](/assets/pinterest-5.19bba24d96246b1b3a2002acb514072fc33fdd23637620770b3fc981f1b332fe.1ce25488.png)

### Configure the Frontegg portal

Once you have obtained your **App id** and **App secret key** from the steps above, enter them in the integration configuration page of the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → Pinterest.
2. Enter the **App id** as the **Client ID** and the **App secret key** as the **Client Secret**.
3. Select the required **scopes**.
4. Click **Save**.


### Additional resources

- [Pinterest API documentation](https://developers.pinterest.com/docs/api/v5/)
- [Pinterest OAuth guide](https://developers.pinterest.com/docs/getting-started/set-up-authentication-and-authorization/)
- [Pinterest developer portal](https://developers.pinterest.com/apps/)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)