> ## Documentation Index
> Fetch the complete documentation index at: https://docs.narrative.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pinterest Connector

> Deliver custom audiences to Pinterest for ad targeting

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](/concepts/apps/app-invites).

## Requirements

### Account access

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

### Supported identifiers

| Identifier Type               | Rosetta Stone Attribute         |
| ----------------------------- | ------------------------------- |
| SHA256 hashed email           | `unique_id.hashed_email.sha256` |
| SHA256 hashed phone           | `unique_id.hashed_phone.sha256` |
| Android advertising ID (GAID) | `unique_id.maid`                |

<Note>
  All PII identifiers must be hashed with SHA256. See [Hashing PII for Upload](/guides/ingestion/hashing-pii) for formatting requirements.
</Note>

## Installation

<Steps>
  <Step title="Navigate to the connector">
    In Narrative, go to **Installed Apps** and select **Pinterest Connector**.
  </Step>

  <Step title="Connect your Pinterest account">
    In the **Profiles** tab, click **Connect** and authorize Narrative to access your Pinterest Business account. You can connect multiple profiles.
  </Step>

  <Step title="Select your ad account">
    In the **Ad Accounts** tab, choose the ad account where audiences will be created.
  </Step>
</Steps>

## Delivering audiences

When configuring a connection to deliver data through the Pinterest Connector, you provide:

| Field                | Description                                                                                                                    |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Audience name        | Display name for the audience in Pinterest (auto-populated from your dataset)                                                  |
| Audience description | Optional description shown in Pinterest                                                                                        |
| Profile              | The Pinterest profile to use for delivery                                                                                      |
| Ad Account           | The ad account where the audience will be created                                                                              |
| Deliver all data     | Whether 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.

<Steps>
  <Step title="Open the profile details">
    In the **Profiles** tab, click **Manage Profile** on the profile you want to reconnect.
  </Step>

  <Step title="Update the token">
    In the **Token Management** section, click **Update token**. A Pinterest OAuth window opens.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Warning>
  You must use the same Pinterest account that was originally used to create the profile. Using a different account will not update the token.
</Warning>

After reconnection, the profile's token expiration date updates and audience delivery resumes.

## Inviting partners

The Pinterest Connector supports [app invites](/concepts/apps/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](/concepts/apps/app-invites).

***

## Related content

<CardGroup cols={2}>
  <Card title="Data Activation Overview" icon="bullseye-arrow" href="/concepts/data-activation/overview">
    Understand how connectors deliver data
  </Card>

  <Card title="App Invites" icon="envelope-open-text" href="/concepts/apps/app-invites">
    Onboard partners with shareable invitation links
  </Card>

  <Card title="Hashing PII" icon="hashtag" href="/guides/ingestion/hashing-pii">
    Prepare identifiers for Pinterest
  </Card>

  <Card title="Structuring Audiences" icon="sitemap" href="/guides/activation/audience-strategies">
    Organize datasets for delivery
  </Card>
</CardGroup>