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

# Pinterest

## Overview

> [card] [Pre-built tooling](#pre-built-tooling)

> [card] [Pre-built integrations](#pre-built-integrations)

> [card] [Access requirements](#access-requirements)

> [card] [Setup guide](#setup-guide)

> [card] [Useful links](#useful-links)

> [card] [API gotchas](#api-gotchas)

## Pre-built tooling

> [accordion] ✅ Authorization
>
> | Tools | Status |
> | - | - |
> | Pre-built authorization (OAuth) | ✅ |
> | Credentials auto-refresh | ✅ |
> | Auth parameters validation | ✅ |
> | Pre-built authorization UI | ✅ |
> | Custom authorization UI | ✅ |
> | Expired credentials detection | ✅ |

> [accordion] ✅ Read & write data
>
> | Tools | Status |
> | - | - |
> | Pre-built integrations | ✅ |
> | API unification | ✅ |
> | 2-way sync | ✅ |
> | Webhooks from Nango on data modifications | ✅ |
> | Real-time webhooks from 3rd-party API | 🚫 (time to contribute: \<48h) |
> | Proxy requests | ✅ |

> [accordion] ✅ Observability & data quality
>
> | Tools | Status |
> | - | - |
> | HTTP request logging | ✅ |
> | End-to-end type safety | ✅ |
> | Data runtime validation | ✅ |
> | OpenTelemetry export | ✅ |
> | Slack alerts on errors | ✅ |
> | Integration status API | ✅ |

> [accordion] ✅ Customization
>
> | Tools | Status |
> | - | - |
> | Create or customize use-cases | ✅ |
> | Pre-configured pagination | 🚫 (time to contribute: \<48h) |
> | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
> | Per-customer configurations | ✅ |

### Others

| Function name | Description | Type |
| - | - | - |
| `create-ad-account-report` | Request an async ad account analytics report. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-ad-account` | Create an ad account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-ad-groups` | Create one or more ad groups. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-ads` | Create one or more ads. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-advertiser-defined-events` | Create custom advertiser-defined conversion event definitions. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-audience` | Create an audience. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-board-section` | Create a board section. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-board` | Create a board. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-campaign` | Create a campaign. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-conversion-tag` | Create a conversion (tracking) tag. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-customer-list` | Create a customer (match audience) list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-customer-segment` | Create a customer segment from existing audiences. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-keywords` | Create targeting keywords | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-labels` | Create ad-entity labels. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-lead-ads-subscription` | Create a webhook subscription for new lead submissions. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-lead-forms` | Create lead-generation ad forms. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-targeting-template` | Create a reusable targeting template. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-advertiser-defined-events` | Delete custom advertiser-defined conversion event definitions. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-board-section` | Delete a board section. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-board` | Delete a board. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-lead-ads-subscription` | Delete a lead ads webhook subscription. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-pin` | Delete a pin. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-promotion` | Delete a Shopping ad promotion. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-ad-account-analytics` | Get account-level analytics | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-ad-account-report` | Get the async ad account analytics report previously requested. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-ad-account` | Retrieve an ad account | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-ad-group-analytics` | Get ad-group-level analytics. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-ad-group-audience-sizing` | Estimate reachable audience size for a targeting spec. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-ad-group` | Retrieve an ad group. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-audience` | Retrieve an audience | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-bid-floors` | Get the minimum allowed bid for given objective/billable-event combinations. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-board-section-pins` | List pins within a specific board section | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-board` | Retrieve a board. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-campaign-analytics` | Get campaign-level analytics. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-campaign` | Retrieve a campaign. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-conversion-tag` | Retrieve a conversion tag. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-customer-list` | Retrieve a customer list | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-featured-trend-topics` | Get Pinterest's featured trending topics for a region. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-interest-targeting-details` | Get details for a specific interest-targeting option. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-keyword-metrics` | Get search-volume metrics for keywords in a country. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-lead-ads-subscription` | Retrieve a lead ads webhook subscription. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-media-upload` | Get the processing status of a registered media upload. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-metrics-ready-state` | Check whether recent analytics data has fully landed (avoid reading partial data). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-ocpm-eligible-conversion-tags` | List conversion tags eligible for oCPM bidding. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-page-visit-conversion-tags` | Get page visit conversion tags | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-pin` | Retrieve a Pin. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-product-category-trend-details` | Get trend details for specific Shopping product categories. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-promotion` | Retrieve a Shopping ad promotion. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-related-terms` | Get terms related to a given term. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-suggested-terms` | Get suggested search terms. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-targeting-options` | Look up valid targeting option values (e.g. interests, locations) by type. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-trending-editorial-articles` | Get Pinterest editorial trend articles for a region. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-trending-keywords` | Get top trending search keywords for a region. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-trending-product-categories` | Get growing Shopping product categories. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-user-account-analytics` | Get organic account analytics. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-user-account-top-pins` | Get top-performing organic pins analytics | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-user-account-top-video-pins` | Get top-performing organic video pins analytics. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-user-account` | Retrieve the connected user account profile. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-user-websites` | List claimed/verified websites for the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-website-verification-code` | Get the meta-tag/HTML-file verification code for claiming a website. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-ad-account-countries` | List countries available for ad account creation/targeting. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-ad-accounts` | List ad accounts. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-ad-groups` | List ad groups. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-ads` | List ads. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-advertiser-defined-events` | List custom advertiser-defined conversion event definitions. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-audiences` | List audiences for an ad account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-board-pins` | List pins on a board | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-board-sections` | List sections on a board. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-boards` | List boards. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-campaigns` | List campaigns. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-catalog-feeds` | List catalog data feeds. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-catalogs` | List product catalogs | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-conversion-tags` | List conversion (tracking) tags. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-customer-lists` | List uploaded customer (match audience) lists. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-customer-segments` | List customer segments (combinations of audiences). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-delivery-metrics` | List available analytics metric definitions | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-followers` | List followers of the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-following-boards` | List boards the user follows. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-following-interests` | List interests the user follows. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-following` | List accounts the user follows. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-keywords` | List targeting keywords for an ad account's ad groups. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-lead-ads-subscriptions` | List webhook subscriptions for new lead submissions. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-lead-forms` | List lead-generation ad forms. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-linked-businesses` | List businesses linked to the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-order-lines` | List insertion-order line items billed to the ad account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-pin-product-tags` | Get product tags on a pin. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-pins` | List pins owned by the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-product-group-promotions` | List product-group-level promotion overrides. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-promotions` | List Shopping ad promotions. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-targeting-templates` | List reusable targeting templates. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `register-media-upload` | Register a media upload and get a signed upload URL. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `save-pin` | Save (repin) an existing pin to one of your boards. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `search-boards` | Search the account's own boards. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `search-pins` | Search the account's own pins. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `send-conversion-events` | Send server-side conversion events (Conversions API). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `unverify-website` | Remove verification for a claimed website. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-ad-groups` | Update one or more ad groups. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-advertiser-defined-events` | Update custom advertiser-defined conversion event definitions | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-audience` | Update an audience (e.g. rename or archive it). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-board-section` | Update a board section. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-board` | Update a board. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-campaigns` | Update one or more campaigns. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-customer-list` | Add or remove records on an existing customer list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-customer-segments` | Update customer segments. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-keywords` | Update targeting keywords. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-targeting-templates` | Update targeting templates | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `ad-accounts` | Sync ad accounts. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `ad-groups` | Sync ad groups. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `ads` | Sync ads. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `analytics` | Sync campaign-level analytics as a rolling date-window snapshot | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `audiences` | Sync audiences. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `board-sections` | Sync sections for every board. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `boards` | Sync boards. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `campaigns` | Sync campaigns. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `catalog-feeds` | Sync catalog data feeds. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `catalog-product-groups` | Sync catalog product groups. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `catalogs` | Sync product catalogs | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `conversion-tags` | Sync conversion (tracking) tags. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `customer-lists` | Sync customer (match audience) lists. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `customer-segments` | Sync customer segments. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `keywords` | Sync targeting keywords. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `lead-forms` | Sync lead-generation ad forms | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `order-lines` | Sync insertion-order line items. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `pins` | Sync pins. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `promotions` | Sync Shopping ad promotions | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `targeting-templates` | Sync reusable targeting templates | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `user-account` | Sync the connected user account profile as a single-record snapshot. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |

> [!NOTE]
>
> Nango has a [Nango-managed OAuth app](https://nango.dev/docs/guides/auth/auth-guide.md#nango-managed-oauth-apps) you can use in development and production. Select it when you create the integration.

## Access requirements

| Pre-Requisites | Status | Comment |
| - | - | - |
| Paid dev account | ❓ | |
| Paid test account | ❓ | |
| Partnership | ❓ | |
| App review | ❓ | |
| Security audit | ❓ | |

## Setup guide

*No setup guide yet.*

> [!TIP]
>
> Need help getting started? Get help in the [community](https://nango.dev/slack).

> [!NOTE]
>
> Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/pinterest.mdx)

## Useful links

* [How to register an Application](https://developers.pinterest.com/docs/getting-started/set-up-app)
* [OAuth-related docs](https://developers.pinterest.com/docs/getting-started/authentication)
* [List of OAuth scopes](https://developers.pinterest.com/docs/getting-started/scopes/#Pinterest%20scopes)
* [API](https://developers.pinterest.com/docs/api/v5)

> [!NOTE]
>
> Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/pinterest.mdx)

## API gotchas

* Access tokens expire within 30 days (2592000 seconds) of being issued. Refresh tokens last for 365 days (31536000 seconds)

> [!NOTE]
>
> Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/pinterest.mdx)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.