Pinterest Ads integration

Listing Pinterest ad accounts

List the Pinterest ad accounts this connection can reach (owned or shared through Business Access) with currency, country, time zone and the connected user's roles. The account in use is named on the integration line; switching accounts happens in the integration settings, not in chat.

Listing Pinterest ad campaigns

List campaigns in the selected Pinterest ad account, newest first, with status, delivery status (summary_status), objective, schedule and daily or lifetime spend caps in the account currency. Page with next_cursor while has_more is true. The selected ad account is applied automatically; never pass one.

Listing Pinterest ad groups

List ad groups in the selected Pinterest ad account, newest first, with their campaign, status, delivery status, budget type (DAILY, LIFETIME, or CBO_ADGROUP when the campaign budget decides), budget and bid in the account currency, billable event, targeting and schedule. Page with next_cursor while has_more is true. The selected ad account is applied automatically; never pass one.

Listing Pinterest ads

List ads (promoted Pins) in the selected Pinterest ad account with their ad group, campaign, Pin id, creative type, destination URL, status, delivery status and review status including rejection reasons. Filter by campaign, ad group or ad ids, one kind at a time. Page with next_cursor while has_more is true. The selected ad account is applied automatically; never pass one.

Checking Pinterest ads metrics status

Check whether Pinterest has finished processing a day's ads metrics: non-conversion metrics (spend, impressions, clicks) and conversion metrics are finalized separately. Use it before calling a recent day's numbers final.

Listing Pinterest targeting options

List the valid values for one Pinterest Ads targeting type in the context of the selected ad account (interests, keywords, locations, languages, ages, genders, app types, audiences), filtered by search and capped. Read-only reference data: targeting cannot be changed through this integration. The selected ad account is applied automatically; never pass one.

Fetching Pinterest ads analytics

Listing Pinterest boards

Updating Pinterest campaigns

Rename, pause or activate up to 30 Pinterest campaigns in one call. PAUSED stops delivery and spend; ACTIVE resumes delivery under the existing budget. Budgets, bids, targeting and schedules cannot be changed here. The user approves the call in chat before it runs, so pass exactly the items and changes that were discussed. The selected ad account is applied automatically; never pass one.

Updating Pinterest ad groups

Rename, pause or activate up to 30 Pinterest ad groups in one call. PAUSED stops delivery and spend; ACTIVE resumes delivery under the existing budget. Budgets, bids, targeting and schedules cannot be changed here. The user approves the call in chat before it runs, so pass exactly the items and changes that were discussed. The selected ad account is applied automatically; never pass one.

Updating Pinterest ads

Rename, pause or activate up to 30 Pinterest ads in one call. PAUSED stops delivery and spend; ACTIVE resumes delivery under the existing budget. Budgets, bids, targeting and schedules cannot be changed here. The user approves the call in chat before it runs, so pass exactly the items and changes that were discussed. The selected ad account is applied automatically; never pass one.

Updating Pinterest campaign spend cap