Pinterest

What’s supported

Supported actions

This connector supports:

• Read Actions, including full historic backfill. Please note that incremental read is not supported, a full read of the Pinterest instance will be done for each scheduled read.
• Write Actions.
• Proxy Actions, using the base URL https://api.pinterest.com.

Supported objects

The pinterest connector supports reading from the following objects:

• pins
• boards
• media
• ad_accounts
• catalogs
• employers
• feeds
• product_groups
• integrations
• stats

The pinterest connector supports writing from the following objects:

• pins
• boards
• media
• ad_accounts
• catalogs
• feeds
• product_groups
• websites
• commerce
• logs
• reports

Example integration

For an example manifest file of an Pinterest integration, visit our samples repo on Github.

Before you get started

To integrate Pinterest with Ampersand, you will need a Pinterest Developer Account.

Once your account is created, you’ll need to create an app in Pinterest, configure the Ampersand redirect URI within the app, and obtain the following credentials from your app:

• App ID
• App Secret
• Scopes

You will then use these credentials and scopes to connect your application to Ampersand.

Create a Pinterest account

Here’s how you can sign up for a Pinterest account:

• Go to the Pinterest Sign Up page and create a business account.
• Verify your account’s email address.
• Sign In to the newly created account and go to My apps.
• Click through to accept Pinterest Developer Terms of Service.

Creating a Pinterest app

Follow the steps below to create a Pinterest app:

1. Log in to your Pinterest Developer Console.
2. Click My Apps.
3. Click Connect App.
4. Enter the app details and click Submit.

📔 Note

You must submit your app for trial access. Once your access is approved, you can log in to manage your app details on the My Apps page, where you can find your app ID and secret.

Adding Ampersand redirect URL to Pinterest app

1. Log in to your Pinterest developer console.

2. Go to My apps and select Manage for the app you want to configure.

3. On the Configure tab scroll to the Redirect URIs section and enter the Ampersand Callback URI: https://api.withampersand.com/callbacks/v1/oauth.

4. Select Add to save your changes

You’ll find the App ID, App Secret, and Scopes keys in the Configure section of your app. These credentials are required for connecting your app to Ampersand, so be sure to note them carefully.

Add Your Pinterest app info to Ampersand

1. Log in to your Ampersand Dashboard.

2. Select the project where you want to create a Pinterest integration.

   

3. Select Provider apps.

4. Select Pinterest from the Provider list.

5. Enter the previously obtained App ID in the App ID field and the App Secret in the App Secret field.

6. Enter the scopes set for your application in Pinterest. For more details on the scopes, go to the Pinterest API Scopes documentation.

   

7. Click Save changes.

Using the connector

To start integrating with Pinterest:

• Create a manifest file using the example.
• Deploy it using the amp CLI.
• If you are using Read Actions, create a destination.
• Embed the InstallIntegration UI component.
• Start using the connector!
  • If your integration has Read Actions, you’ll start getting webhook messages.
  • If your integration has Write Actions, you can start making API calls to our Write API.
  • If your integration has Proxy Actions, you can start making Proxy API calls.