ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

targeting_template

Create targeting templates

Changed on Jun 4, 2026

Targeting templates allow advertisers to save a set of targeting details including audience lists, keywords & interest, demographics, and placements to use more than once during the campaign creation process.

Templates can be used to build out basic targeting criteria that you plan to use across campaigns and to reuse performance targeting from prior campaigns for new campaigns.

post/ad_accounts/{ad_account_id}/targeting_templates

Request

Base URL
https://api.pinterest.com/v5
Auth
OAuth 2
Authorization codehttps://www.pinterest.com/oauth/
Token URLhttps://api.pinterest.com/v5/oauth/token
Scopesads:write
TypeScript
https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/targeting_templates/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Request body

auto_targeting_enabledboolean

Enable auto-targeting for ad group. Also known as "expanded targeting".

namestring required

targeting template name

placement_group'ALL' | 'SEARCH' | 'BROWSE' | 'OTHER'

Campaign placement group type

Example request

{
  "keywords": [
    {
      "match_type": "BROAD",
      "value": "couples halloween costumes"
    }
  ],
  "placement_group": "ALL",
  "targeting_attributes": {
    "SHOPPING_RETARGETING": [
      {
        "lookback_window": 30,
        "exclusion_window": 14,
        "tag_types": [
          0,
          6
        ]
      }
    ]
  },
  "tracking_urls": {
    "impression": [
      "URL1",
      "URL2"
    ],
    "click": [
      "URL1",
      "URL2"
    ],
    "engagement": [
      "URL1",
      "URL2"
    ],
    "buyable_button": [
      "URL1",
      "URL2"
    ],
    "audience_verification": [
      "URL1",
      "URL2"
    ]
  }
}

Response

The request has succeeded.

ad_account_idstring

The ID of the advertiser that this targeting template belongs to.

auto_targeting_enabledboolean

Enable auto-targeting for ad group. Also known as "expanded targeting".

created_timeinteger

Targeting template created time. Unix timestamp in seconds.

idstring

Targeting template ID.

namestring required

targeting template name

placement_group'ALL' | 'SEARCH' | 'BROWSE' | 'OTHER'

Campaign placement group type

status'ACTIVE' | 'DELETED'

Indicate targeting template is active or Deleted

updated_timeinteger

Targeting template updated time.Unix timestamp in seconds.

validboolean nullable

Inform if the targeting template is valid (ex. would be false if has revoked audience)

Example response

{
  "keywords": [
    {
      "match_type": "BROAD",
      "value": "couples halloween costumes"
    }
  ],
  "placement_group": "ALL",
  "sizing": {
    "reach_estimate": {
      "estimate": 63492000,
      "lower_bound": 47619000,
      "upper_bound": 79365000
    }
  },
  "targeting_attributes": {
    "SHOPPING_RETARGETING": [
      {
        "lookback_window": 30,
        "exclusion_window": 14,
        "tag_types": [
          0,
          6
        ]
      }
    ]
  },
  "tracking_urls": {
    "impression": [
      "URL1",
      "URL2"
    ],
    "click": [
      "URL1",
      "URL2"
    ],
    "engagement": [
      "URL1",
      "URL2"
    ],
    "buyable_button": [
      "URL1",
      "URL2"
    ],
    "audience_verification": [
      "URL1",
      "URL2"
    ]
  }
}

Changes

Jun 4, 2026v5b698c180678a Revision changes
- breaking
  added the new required request property
- breaking
  added the new required request property
- warning
  removed subschema #2 from the request body allOf list
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  removed subschema #2: TargetingTemplateGetResponseData from the response body allOf list for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the success response with the status
Dec 11, 2025v5537bde5a50b1 Revision changes
- breaking
  the ////////// response property's minItems was decreased from 100 to 0 for the response status
- breaking
  the ////////// response property's minItems was decreased from 100 to 0 for the response status

Operation history (5 revisions)