Skip to content

Developer Platform

Search docs & API
Log in
Sign up

Enable Pinterest Performance+ in campaigns

Pinterest Performance+ bundles Pinterest's automation and AI features to simplify campaign creation and boost campaigns, maximizing ad impressions. Learn more about Pinterest Performance+ features.
You can enable Pinterest Performance+ in campaigns with the following objectives:
  • CONSIDERATION
  • CONVERSION
  • CATALOG_SALES
As part of objective simplification, the
CATALOG_SALES
objective is being deprecated, to be replaced by the
SALES
objective. See the details and timeline for objective simplification.
As part of objective simplification, the
CATALOG_SALES
objective is being deprecated, to be replaced by the
SALES
objective. See the details and timeline for objective simplification.
You can enable additional creative optimizations for
CATALOG_SALES
campaigns with Pinterest Performance+ Creative. Learn more.

Create entities for a Pinterest Performance+ campaign

To create a Pinterest Performance+ campaign, take the following steps:

Step 1: Create a campaign

Endpoint

POST
Create campaigns

Parameters to include

Do not include any parameters not listed in this table.
Do not include any parameters not listed in this table.
Pinterest Performance+ campaign parameters
ParameterNotes
ad_account_id
Required
name
Required.
status
Required.
lifetime_spend_cap
Use this parameter or
daily_spend_cap
, but not both.
daily_spend_cap
Use this parameter or
lifetime_spend_cap
, but not both.
If using this parameter, set
is_flexible_daily_budgets
to
TRUE
.
order_line_id
Optional.
tracking_urls
Optional.
start_time
Required.
end_time
Optional.
is_flexible_daily_budgets
Set to
TRUE
when
daily_spend_cap
is set. Otherwise, do not include.
objective_type
Required.
Pinterest Performance+ supports
CONSIDERATION
CATALOG_SALES
and
WEB_CONVERSIONS
is_performance_plus
Set to
TRUE
.

Parameters not to include

Make sure not to inclue the following parameters when creating a Peformance+ campaign:
  • default_ad_group_budget_in_micro_currency
  • is_automated_campaign

Step 2: Create an ad group under the Pinterest Performance+ campaign

Create only one ad group.
When you create an ad group under a Pinterest Performance+ campaign, Pinterest automatically creates additional sibling ad groups based on the campaign objective and other factors.

Ad group auto-creation

A Pinterest Performance+ campaign always includes one base ad group that aggregates all of the campaign's necessary ad group settings. The base ad group is also known as a prospecting ad group because it is used for prospecting for new users.
The campaign may also include any of these other types:
  • Retargeting ad group for serving catalog-based ads to people who have previously shown intent, for example, by viewing products or adding items to a cart.
  • Included audiences ad group that targets audience lists.
  • Customer segment ad group that targets users who are defined in the ad group's targeting profile.
Pinterest Performance+ works with ad groups differently, depending on the campaign objective.
  • For
    CONVERSION
    and
    CONSIDERATION
    objectives: If you include one or more customer lists in your campaign, Pinterest creates a second remarketing Ad Group from your customer lists.
  • For the
    CATALOG_SALES
    objective: Pinterest creates a prospecting ad group using the
    ALL_PRODUCTS
    product group, and another dynamic retargeting ad group to remarket to users. You cannot opt out of the dynamic retargeting ad group during the create flow experience, nor can you control the percentage of spend that goes to each ad group.
  • If you add a customer list to your Pinterest Performance+
    CATALOG_SALES
    campaign, Pinterest makes a third ad group targeting those users.

Parameters that are synced and unsynced across ad groups

Pinterest syncs values for most ad group parameters across all ad groups under the campaign, so if you add or change a parameter for one ad group, it is applied to all the other sibling ad groups.
All ad group parameters are synced except for the following:
  • name
  • tracking_urls
  • status
  • targeting_template_ids
  • default_utm_source_enabled
  • custom_url_parameters
  • bid_multiplier
  • PINNER_LIST_INCLUDE
  • PINNER_LIST_EXCLUDE
  • SHOPPING_RETARGETING
When adding or changing an unsynced parameter, manually apply it across sibling ad groups.
When adding or changing an unsynced parameter, manually apply it across sibling ad groups.

Endpoint

POST
Create ad groups

Parameters to include

Do not include any parameters not listed in this table.
Do not include any parameters not listed in this table.
Pinterest Performance+ ad group parameters
ParameterNotes
name
Required.
status
Required.
Default is
ACTIVE
.
optimization_goal_metadata
Required for
CATALOG_SALES
and conversions objectives.
conversion_tag_v3_goal_metadata.conversion_event
Required for
CATALOG_SALES
and conversions objectives.
Set one of the following:
  • add_to_cart
  • checkout
  • signup
  • lead
conversion_tag_v3_goal_metadata
(All other parameters)
Optional.
frequency_goal_metadata
Optional.
targeting_spec.AGE_BUCKET
Optional.
For all ages, do not set any value.
For 18+, set to all of the following:
  • 18-24
  • 25-34
  • 35-44
  • 45-49
  • 50-54
  • 55-64
  • 65+
targeting_spec.AUDIENCE_EXCLUDE
Optional.
targeting_spec.AUDIENCE_INCLUDE
Optional.
targeting_spec.GEO
Required.
Set at least one of
GEO
or
LOCATION
.
targeting_spec.LOCATION
Required.
Set at least one of
GEO
or
LOCATION
.
targeting_spec
(all other targeting types)
Do not set any value.
Not supported by Pinterest Performance+.
tracking_urls
Optional.
campaign_id
Required.
billable_event
Required.
bid_strategy_type
Required.
Set to
AUTOMATIC_BID
only.
is_creative_optimization
Optional.
Use to enable Pinterest Performance+ Creative optimizations.

Parameters not to include

Make sure you do not include the following parameters when creating a Pinterest Performance+ ad group:
  • budget_in_micro_currency
  • bid_in_micro_currency
  • scrollup_goal_metadata
  • budget_type
  • start_time
  • end_time
  • placement_group
  • pacing_delivery_type
  • targeting_template_ids
  • auto_targeting_enabled

Step 3: Create an ad (conversion and consideration objectives)

For a Pinterest Performance+
CATALOG_SALES
campaign, go to Step 3: Create a product group promotion (
CATALOG_SALES
objective).
For a Pinterest Performance+
CATALOG_SALES
campaign, go to Step 3: Create a product group promotion (
CATALOG_SALES
objective).
Create an ad under a Pinterest Performance+ Ad Group. Pinterest automatically duplicates the ad across all ad groups under the Pinterest Performance+ campaign. You can create multiple ads.
Do not create lead, showcase or quiz ads because they are not supported for Pinterest Performance+.

Endpoint

POST
Create ads

Parameters to include

Do not include any parameters not listed in this table.
Do not include any parameters not listed in this table.
Pinterest Performance+ ad parameters
ParameterNotes
ad_group_id
Required.
android_deep_link
Optional.
carousel_android_deep_links
Optional.
carousel_destination_urls
Optional.
carousel_ios_deep_links
Optional.
click_tracking_url
Optional.
creative_type
Required.
Set to any value except:
SHOPPING
QUIZ
or
SHOWCASE
.
destination_url
Optional.
ios_deep_link
Optional.
is_removable
Optional.
name
Optional.
status
Required.
Default is
ACTIVE
.
tracking_urls
Optional.
view_tracking_url
Optional.
customizable_cta_type
Optional.
pin_id
Required.

Parameters not to include

Make sure not to include the following parameters when creating an ad in a Pinterest Performance+ campaign:
  • is_pin_deleted
  • lead_form_id
  • grid_click_type
  • quiz_pin_data

Step 3: Create a product group promotion (catalog sales objective)

Pinterest Performance+ only supports the autogenerated
ALL_PRODUCTS
product groups, which you can identify by calling
GET
Get a product group promotion by id
or
GET
Get product group promotions
and viewing the type field in the response.
Pinterest Performance+ only supports the autogenerated
ALL_PRODUCTS
product groups, which you can identify by calling
GET
Get a product group promotion by id
or
GET
Get product group promotions
and viewing the type field in the response.
Create the product group promotion under the Pinterest Performance+ campign. Pinterest automatically duplicates the promotion across all ad groups under the campaign. Currently we only support one product group promotion per ad group.

Endpoint

POST
Create product group promotions

Parameters to include

Do not include any parameters not listed in this table.
Do not include any parameters not listed in this table.
Pinterest Performance+ product group parameters
ParameterNotes
id
Required.
ad_group_id
Required.
is_mdl
Optional.
status
Required.
Default is
ACTIVE
.
tracking_url
Optional.
catalog_product_group_id
Required.
Pinterest Performance+ only supports autogenerated
ALL_PRODUCTS
product groups.
creative_type
Required.
Set to
SHOPPING
only.
is_generate_background
Optional.
Only supported for
CATALOG_SALES
. Learn more about generating backgrounds.

Parameters not to include

Make sure not to include the following parameters when creating a product group promotion in a Pinterest Performance+ campaign:
  • bid_in_micro_currency
  • included
  • definition
  • relative_definition
  • parent_id
  • slideshow_collections_title
  • slideshow_collections_description
  • catalog_product_group_name
  • collections_hero_pin_id
  • collections_hero_destination_url
  • grid_click_type

Update entities in a Pinterest Performance+ campaign

Learn how updates work with Pinterest Performance+ campaigns.

Update a campaign

PATCH
Update campaigns
The process is identical to updating any other campaign; however, you cannot update a Pinterest Performance+ campaign to become a non-Pinterest Performance+ campaign. Instead, you would need to archive the campaign and create a new one.

Update an ad group

Endpoint

PATCH
Update ad groups

Parameters that can be updated

  • name
  • frequency_goal_metadata
  • tracking_urls
  • optimization_goal_metadata
  • targeting_spec:
    • AGE_BUCKET
    • AUDIENCE_EXCLUDE
      *
    • GEO
      *
    • LOCATION
      *
    • AUDIENCE_INCLUDE
      (You can only add or remove this parameter in an ad group that has an
      AUDIENCE_INCLUDE
      set.)
    • status
      (Except for
      ARCHIVED
      )
    • is_creative_optimization
* For these parameters, you must apply the same change to all ad groups under the same Pinterest Performance+ campaign. Send all ad groups in the campaign in one API call.

Update ads

Each ad group in a Pinterest Performance+ campaign can contain more than one ad.
When changing an ad, send all the ads in the same index position in a single API call. To find relevant ads, call
GET
List ads
and filter by the
ad_group_ids
parameter.

Endpoint

PATCH
Update ads

Parameters that can be updated

  • android_deep_link
  • carousel_android_deep_links
  • carousel_destination_urls
  • carousel_ios_deep_links
  • click_tracking_url
  • destination_url
  • ios_deep_link
  • is_removable
  • name
  • tracking_urls
  • view_tracking_url
  • customizable_cta_type

Update a Product Group Promotion

Each ad group in a Pinterest Performance+ campaign can contain only one product group promotion.
When making an update, make the same change across all the product group promotions under Pinterest Performance+ ad groups.

Endpoint

PATCH
Update product group promotions

Parameters that can be updated

  • is_mdl
  • status
  • tracking_url
  • catalog_product_group_id

Focus on new customer acquisition

By adding several parameters to campaigns and ad groups, you can focus a Pinterest Performance+ campaign on new customer acquisition (NCA) to unlock deliberate ads delivery modifications.
You can define your existing customer segment and express the relative value of a new customer conversion by setting a value rule with the bid multiplier.

Step 1: Add NCA-supporting parameters to a Performance+ campaign

When creating, or updating a Pinterest Performance+ campaign, include the following parameters:
Performance Plus campaign settings request fields
FieldDescription
performance_plus_campaign_settings

object
Optional but necessary for this use case
Container for settings that only apply to Pinterest Performance+ campaigns, and are otherwise omitted.
performance_plus_campaign_settings.

boost_prospecting_ad_group_bid

boolean
Optional but necessary for this use case
Set to
true
to prioritize new customers by applying a bid multiplier to the campaign's prospecting ad group ID.
performance_plus_campaign_settings.

pinner_list_exclusions

array of strings
Optional but necessary for this use case
Pass audience list ids of existing customers to exclude these from targeting so that the campaign is biased toward new customers.

Example request

curl --request POST \
  --url https://api.pinterest.com/v5/ad_accounts/123456789012/campaigns \
  --header 'authorization: Bearer pina_ABCD1234...' \
  --header 'content-type: application/json' \
  --data' [
{
    "advertiser_id": "ADV_ID",
    "name": "Catalog sales Campaign | 2026-03-25 18:27 UTC",
    "status": "ACTIVE",
    "lifetime_spend_cap": 0,
    "daily_spend_cap": 20000000,
    "is_campaign_budget_optimization": true,
    "start_time": 1774463220,
    "is_flexible_daily_budgets": true,
    "is_performance_plus": true,
    "performance_plus_campaign_settings": {
        "pinner_list_exclusions": [],
        "boost_prospecting_ad_group_bid": true
    },
    "objective_type": "CATALOG_SALES"
}
]'

Step 2: Add NCA-supporting parameters to a Performance+ ad group

As with any Pinterest Performance+ campaign, when you manually create an NCA-focused ad group, Pinterest auto-generates additional ones.
In addition to the groups previously listed, an NCA-focused campaign may also include a customer segment regargeting ad group that reaches people who have visited your site, purchased products, engaged with your Pins ads, or engaged in other ways.
When creating, or updating a Pinterest Performance+ ad group, include the following parameters:
Performance Plus campaign and ad group request fields
ParameterDescription
performance_plus_campaign_settings

object
Optional, but necessary for this use case
Container for settings that only apply to Pinterest Performance+ campaigns, and are otherwise omitted.
performance_plus_campaign_settings.boost_prospecting_ad_group_bid

boolean
Optional, but necessary for this use case
Set to
true
to prioritize new customers by applying a bid multiplier to the campaign's retargeting and prospecting—or base—ad group.
performance_plus_campaign_settings.pinner_list_exclusions

array of strings
Optional, but necessary for this use case
Pass audience lists of existing customers to exclude these from targeting so that the campaign is biased toward new customers.
feed_profile_id

string
Optional, but necessary for this use case
For campaigns with a
CATALOG_SALES
objective, pass the ID of the merchant feed profile that the ad group should use for catalog-based delivery.
You can retrieve the ID by calling
GET
List feeds
.
targeting_spec.

AUDIENCE_INCLUDE

array of strings, nullable
Optional
Omit for NCA-focused campaigns.

Example request

curl --request POST \
  --url https://api.pinterest.com/v5/ad_accounts/123456789012/ad_groups \
  --header 'authorization: Bearer pina_ABCD1234...' \
  --header 'content-type: application/json' \
  --data '[
{
    "name": "Catalog sales Ad group | 2026-03-25 18:27 UTC",
    "status": "ACTIVE",
    "budget_type": "CBO_ADGROUP",
    "bid_multiplier": 0,
    "auto_targeting_enabled": true,
    "placement_group": "ALL",
    "pacing_delivery_type": "STANDARD",
    "bid_strategy_type": "AUTOMATIC_BID",
    "feed_profile_id": "1234567890",
    "optimization_goal_metadata": {
        "frequency_goal_metadata": {}
    },
    "targeting_spec": {
        "AGE_BUCKET": [],
        "APPTYPE": [
            "web",
            "ipad",
            "web_mobile",
            "iphone",
            "android_mobile",
            "android_tablet"
        ],
        "DEVICE_MODEL": [],
        "INTERNET_SERVICE_PROVIDER": [],
        "AUDIENCE_EXCLUDE": [],
        "GENDER": [
            "female",
            "male",
            "unknown"
        ],
        "INTEREST": [],
        "LOCALE": [],
        "LOCATION": [
            "US"
        ],
        "TARGETING_STRATEGY": [
            "CHOOSE_YOUR_OWN"
        ]
    },
    "tracking_urls": {},
    "customer_segment_id": "1234567890",
    "is_creative_optimization": "OPT_IN",
    "is_simplified_targeting": false,
    "performance_plus_campaign_settings": {
        "pinner_list_exclusions": [],
        "boost_prospecting_ad_group_bid": true
    },
    "campaign_id": "CAMPAIGN_ID",
    "billable_event": "CLICKTHROUGH"
}
]'

Step 3: Create an ad for an NCA-focused campaign

The process is the same as for any Pinterest Performance+ ad.

Step 3: Create a product group promotion for an NCA-focused campaign

The process is the same as for any Pinterest Performance+ product group promotion.

Update a Pinterest Performance+ ad group that focuses on NCA

PATCH
Update ad groups
The method for updating an ad group depends on your use case.

Change a non-NCA ad group to an NCA-focused one

  1. Make sure the parent campaign is Pinterest Performance+ enabled and focused on NCA.
  2. Add NCA-related fields to the ad group.

Remove the NCA focus an existing Performance+ ad group (disable customer segments)

  1. Remove the NCA-related fields from the parent campaign.
  2. For the customer segment and customer segment retargeting ad groups, set
    customer_segment_id
    to
    0
    .

Change the customer segment used for NCA

In the customer segment and customer segment retargeting ad groups:
  1. Change the
    customer_segment_id
    value to reflect the new segment you want to target.
  2. Clear the
    AUDIENCE_INCLUDE
    parameter.

Add bid multiplier to an NCA-focused ad group

This assumes the parent campaign is NCA-focused.
In the base and retargeting ad groups, add the
bid_multiplier
parameter.

Remove bid multiplier from an NCA-focused ad group

In the base and retargeting ad groups, set
bid_multiplier
to
0
.

Update other Pinterest Performance+ entities that focus on NCA

For an NCA-focused campaign, ad, or product group, the update processes are the same as for those Pinterest Performance+ entities.
Was this page helpful?