Skip to main content
The Pinterest Connector delivers audience data to Pinterest, enabling you to create custom audiences for advertising campaigns on the Pinterest platform.

​
Overview

The connector pushes your audience data to Pinterest, where it becomes available as a Custom Audience for targeting in your Pinterest ad campaigns. You can connect multiple Pinterest profiles, manage ad accounts, and invite third-party partners to connect their accounts using app invites.

​
Requirements

​
Account access

  • A Pinterest Business account
  • Access to Pinterest Ads Manager
  • Appropriate permissions to create Custom Audiences

​
Supported identifiers

Identifier TypeRosetta Stone Attribute
SHA256 hashed emailunique_id.hashed_email.sha256
SHA256 hashed phoneunique_id.hashed_phone.sha256
Android advertising ID (GAID)unique_id.maid
All PII identifiers must be hashed with SHA256. See Hashing PII for Upload for formatting requirements.

​
Installation

1

Navigate to the connector

In Narrative, go to Installed Apps and select Pinterest Connector.
2

Connect your Pinterest account

In the Profiles tab, click Connect and authorize Narrative to access your Pinterest Business account. You can connect multiple profiles.
3

Select your ad account

In the Ad Accounts tab, choose the ad account where audiences will be created.

​
Delivering audiences

When configuring a connection to deliver data through the Pinterest Connector, you provide:
FieldDescription
Audience nameDisplay name for the audience in Pinterest (auto-populated from your dataset)
Audience descriptionOptional description shown in Pinterest
ProfileThe Pinterest profile to use for delivery
Ad AccountThe ad account where the audience will be created
Deliver all dataWhether to include historical data already in the dataset, or only deliver new data written after the connection is configured

​
Reconnecting a profile

Pinterest OAuth tokens expire periodically. When a token expires, the connector can no longer deliver audiences through that profile. Instead of deleting and recreating the profile, you can refresh the token in place.
1

Open the profile details

In the Profiles tab, click Manage Profile on the profile you want to reconnect.
2

Update the token

In the Token Management section, click Update token. A Pinterest OAuth window opens.
3

Re-authorize with Pinterest

Sign in with the same Pinterest account that was originally used to create the profile and authorize access. The window closes automatically when complete.
You must use the same Pinterest account that was originally used to create the profile. Using a different account will not update the token.
After reconnection, the profile’s token expiration date updates and audience delivery resumes.

​
Inviting partners

The Pinterest Connector supports app invites, which let you onboard third-party partners without requiring them to have a Narrative account. In the App Invites tab, you can generate shareable invitation links that allow partners to connect their Pinterest accounts directly. Each invite includes a unique URL and code. When a partner opens the link and authorizes their Pinterest account, a profile is automatically created in your Narrative account.

​
Reconnect invites

You can also create app invites that allow a partner to refresh the OAuth token on an existing profile. When creating an invite, select Update existing profile token and choose the profile to reconnect. The partner receives a link that walks them through the same OAuth flow, updating the token on the existing profile rather than creating a new one. For more details on how app invites work, see App Invites.

​
Related content

Data Activation Overview

Understand how connectors deliver data

App Invites

Onboard partners with shareable invitation links

Hashing PII

Prepare identifiers for Pinterest

Structuring Audiences

Organize datasets for delivery