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

# Pinterest

> Let the Dema Agent read Pinterest ad account, campaign, and pin performance, and manage campaigns, ad groups, ads, audiences, boards, and pins.

## Overview

Once Pinterest is connected, the Dema Agent can browse your ad accounts, campaigns, ad groups, and ads, read their performance, and make changes — create and update campaigns, ad groups, ads, and targeting audiences. It can also work with your organic content: list boards and pins, read pin analytics, and create new pins and boards. Useful for diagnosing paid social performance and applying Dema recommendations without leaving a conversation.

The agent only acts when you ask it to, and you can ask it to describe any change before it applies it.

### What the agent can do

* **Ad accounts** — list the ad accounts you've shared and read account-level analytics.
* **Campaigns** — list, read, create, and update campaigns, and read campaign analytics.
* **Ad groups** — list, read, create, and update ad groups, and read ad group analytics.
* **Ads** — list, read, create, and update ads, and read ad analytics.
* **Audiences** — list, create, and update targeting audiences.
* **Boards and pins (organic)** — list boards and pins, read pin analytics, and create pins and boards.
* **Account** — read your Pinterest user profile.

***

## Prerequisites

* A Pinterest Business account with access to the ad accounts you want Dema to use.

***

## Connect Pinterest

1. In Dema, go to **Agents → Settings → Integrations**.
2. Find **Pinterest** and click **Connect**.
3. Sign in to Pinterest and approve the scopes Dema requests.
4. Choose which ad accounts Dema can access.
5. You are returned to Dema with the integration marked as Active.

***

## Scopes Dema requests

| Scope                                 | What it allows                                                              |
| ------------------------------------- | --------------------------------------------------------------------------- |
| `user_accounts:read`                  | Read your Pinterest account profile                                         |
| `ads:read`                            | Read ad accounts, campaigns, ad groups, ads, audiences, and their analytics |
| `ads:write`                           | Create and update campaigns, ad groups, ads, and audiences                  |
| `boards:read`, `boards:read_secret`   | List and read boards, including secret boards                               |
| `boards:write`, `boards:write_secret` | Create boards, including secret boards                                      |
| `pins:read`, `pins:read_secret`       | List and read pins and pin analytics, including secret pins                 |
| `pins:write`, `pins:write_secret`     | Create pins, including secret pins                                          |

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="An ad account is missing">
    Dema only works with the ad accounts you shared during the connect step. If an account is missing, click **Reconnect** on the Pinterest integration card and select it.
  </Accordion>

  <Accordion title="Dema says my connection has expired">
    This happens when Dema cannot refresh the access token, usually because access was revoked in Pinterest. Click **Reconnect** on the integration card to re-authorize.
  </Accordion>

  <Accordion title="The agent cannot create or update campaigns">
    Creating and updating campaigns, ad groups, ads, and audiences requires that the connected Pinterest account has permission to manage the target ad account. Confirm the account has advertiser access, then ask the agent again.
  </Accordion>
</AccordionGroup>

If you are still stuck, contact [support](mailto:info@dema.ai) with the error message you see.

***

## Additional resources

* [Pinterest Business Help Center](https://help.pinterest.com/en/business)
* [Pinterest API (v5) documentation](https://developers.pinterest.com/docs/api/v5/)