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

labels

Create labels

Changed on Jun 4, 2026

Closed beta

Apply one or more labels to a campaign. Future releases may support labels for other entities. Currently, you can apply brand and custom labels. Future releases will provide more options.

Note: You can only apply one brand label to a campaign. You can apply 30 custom labels to a campaign.

post/ad_accounts/{ad_account_id}/labels

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/labels/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

Response

The request has succeeded.

Changes

Jun 4, 2026v5b698c180678a Revision changes
- breaking
  the request property // became not nullable
- breaking
  removed the enum value undefined of the request property //
- breaking
  the /// response's property type changed from string to no type for status
- breaking
  the // response's property type changed from string to no type for status
- warning
  removed the request property
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the 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 non-success response with the status
- info
  added the non-success response with the status
- info
  added to the /// response property allOf list for the response status
- info
  added to the // response property allOf list for the response status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
Oct 16, 2025v514c297539b64 Revision changes
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- warning
  changed the pattern of the request property from ^\d+$ to ^[C]?\d+$
- warning
  added the new ACTIVE enum value to the /// response property for the response status
- warning
  added the new ACTIVE enum value to the // response property for the response status
- warning
  added the new ARCHIVED enum value to the /// response property for the response status
- warning
  added the new ARCHIVED enum value to the // response property for the response status
- warning
  added the new BRAND enum value to the /// response property for the response status
- warning
  added the new BRAND enum value to the // response property for the response status
- warning
  added the new CAMPAIGN enum value to the /// response property for the response status
- warning
  added the new CAMPAIGN enum value to the // response property for the response status
- warning
  added the new CUSTOM enum value to the /// response property for the response status
- warning
  added the new CUSTOM enum value to the // response property for the response status
- warning
  added the new undefined enum value to the /// response property for the response status
- warning
  added the new undefined enum value to the /// response property for the response status
- warning
  added the new undefined enum value to the /// response property for the response status
- warning
  added the new undefined enum value to the // response property for the response status
- warning
  added the new undefined enum value to the // response property for the response status
- warning
  added the new undefined enum value to the // response property for the response status
- info
  the request property // became nullable
- info
  added the new undefined enum value to the request property //

Operation history (4 revisions)