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

# Pinterest

## Overview

<CardGroup cols={3}>
  <Card title="Pre-built tooling" icon="screwdriver-wrench" href="#pre-built-tooling" />

  <Card title="Pre-built integrations" icon="square-check" href="#pre-built-integrations" />

  <Card title="Access requirements" icon="triangle-exclamation" href="#access-requirements" />

  <Card title="Setup guide" icon="rocket" href="#setup-guide" />

  <Card title="Useful links" icon="circle-info" href="#useful-links" />

  <Card title="API gotchas" icon="biohazard" href="#api-gotchas" />
</CardGroup>

## Pre-built tooling

<AccordionGroup>
  <Accordion title="✅ Authorization">
    | Tools                           | Status |
    | ------------------------------- | ------ |
    | Pre-built authorization (OAuth) | ✅      |
    | Credentials auto-refresh        | ✅      |
    | Auth parameters validation      | ✅      |
    | Pre-built authorization UI      | ✅      |
    | Custom authorization UI         | ✅      |
    | Expired credentials detection   | ✅      |
  </Accordion>

  <Accordion title="✅ 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>

  <Accordion title="✅ 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>

  <Accordion title="✅ 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        | ✅                              |
  </Accordion>
</AccordionGroup>

### Others

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

## 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).</Tip>

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

## 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)</Note>

## 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)</Note>
