Skip to main content

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

ScopeWhat it allows
user_accounts:readRead your Pinterest account profile
ads:readRead ad accounts, campaigns, ad groups, ads, audiences, and their analytics
ads:writeCreate and update campaigns, ad groups, ads, and audiences
boards:read, boards:read_secretList and read boards, including secret boards
boards:write, boards:write_secretCreate boards, including secret boards
pins:read, pins:read_secretList and read pins and pin analytics, including secret pins
pins:write, pins:write_secretCreate pins, including secret pins

Troubleshooting

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.
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.
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.
If you are still stuck, contact support with the error message you see.

Additional resources