Skip to main content
Version: v3
POST 
/ad_accounts/:ad_account_id/ad_groups

Create an ad group.

Starting July 13th, 2026, conversion_pixel_id is required for all ad groups. Retrieve your Pixel with List Pixels by Ad Account.

Optimization goal options​

optimization_goal is required for conversion, video views, catalog sales, and app install campaign objectives.

Conversion

Starting May 5th, VIEW_CONTENT, SEARCH, and ADD_TO_WISHLIST will no longer be supported for new ad groups. Existing ad groups using these goals won't be affected, but they can't be created, extended, duplicated, or replicated.

  • PAGE_VISIT
  • VIEW_CONTENT
  • SEARCH
  • ADD_TO_CART
  • ADD_TO_WISHLIST
  • PURCHASE
  • LEAD
  • SIGN_UP
  • CLICKS

CLICKS is only available if neither Pixel nor CAPI has been set up.

Video views

Starting March 31st, 2026, NULL is no longer supported. Set to a valid video goal to prevent issues. Learn about video goals.

  • VIDEO_VIEW_6S
Catalog sales
  • PURCHASE
  • CLICKS

CLICKS is only available if neither Pixel nor CAPI has been set up.

App install

Learn more about app event goals.

  • MOBILE_CONVERSION_INSTALL
  • MOBILE_CONVERSION_SIGN_UP
  • MOBILE_CONVERSION_ADD_PAYMENT_INFO
  • MOBILE_CONVERSION_ADD_TO_CART
  • MOBILE_CONVERSION_PURCHASE
  • MOBILE_CONVERSION_COMPLETED_TUTORIAL
  • MOBILE_CONVERSION_LEVEL_ACHIEVED
  • MOBILE_CONVERSION_SPEND_CREDITS
  • MOBILE_CONVERSION_REINSTALL
  • MOBILE_CONVERSION_UNLOCK_ACHIEVEMENT
  • MOBILE_CONVERSION_START_TRIAL
  • MOBILE_CONVERSION_SUBSCRIBE
  • MOBILE_CONVERSION_ONBOARD_STARTED
  • MOBILE_CONVERSION_FIRST_TIME_PURCHASE

When shopping_type is DYNAMIC, see the targeting field description for which fields are applied.

Rate Limit​

See the rate limits for Campaign Management Write

Policy Slug: ads-campaign-management-write
  • Window: 60 seconds
  • Quota: 200 requests

Request​

Responses​

An ad group.