v5.15.0
What's Changed
Pins
GET /pins
- Removed
media_typefrom response, added support for video cover frame time and improved video media structure.
POST /pins
- Removed
media_type, addedsponsor_idand video cover frame time, improved media schema. Now supportsclient_credentials.
DELETE /pins/{pin_id}
- Now supports
client_credentialssecurity.
GET /pins/{pin_id}
- Same as GET /pins: removed
media_type, added video frame time, improved media schema.
PATCH /pins/{pin_id}
- Removed
media_type, added video cover frame time. Now supportsclient_credentials.
POST /pins/{pin_id}/save
- Same media property changes as POST /pins.
GET /search/partner/pins
- Removed
media_type, improved media structure and added ID property.
Ad Accounts
GET /ad_accounts
- Now supports
client_credentials.
POST /ad_accounts
- Added optional property:
currency.
GET /ad_accounts/{ad_account_id}
- Now supports
client_credentials.
Campaigns
GET /ad_accounts/{ad_account_id}/campaigns
- Added automated and Performance+ campaign properties.
- Now supports
client_credentials.
PATCH /ad_accounts/{ad_account_id}/campaigns
- Added automated, Performance+ campaign properties; removed old automated property.
GET /ad_accounts/{ad_account_id}/campaigns/{campaign_id}
- Added automated and Performance+ campaign properties.
- Now supports
client_credentials.
GET /ad_accounts/{ad_account_id}/campaigns/analytics
- Analytics: campaign_id now optional, added aggregate reporting support.
Ad Groups
GET /ad_accounts/{ad_account_id}/ad_groups
- Added creative optimization, promotion ID, bid multiplier; expanded age targeting with
19+and20+. - Now supports
client_credentials.
PATCH /ad_accounts/{ad_account_id}/ad_groups
- Frequency goal min/max changed (2–20); added creative optimization, promotion ID, bid multiplier, new age buckets.
GET /ad_accounts/{ad_account_id}/ad_groups/{ad_group_id}
- Same new fields as GET.
- Now supports
client_credentials.
Ads
GET /ad_accounts/{ad_account_id}/ads
- Added new CTAs (e.g., "BUY_TICKETS", "DONATE_NOW", "DOWNLOAD", "PLAY_GAME", "TRY_IT"). Now supports
client_credentials.
PATCH /ad_accounts/{ad_account_id}/ads
- Same as above for CTAs and property expansions.
POST /ad_accounts/{ad_account_id}/ads
- Same as above for CTAs and property expansions.
Audiences
GET /ad_accounts/{ad_account_id}/audiences
- Added
created_by_company_name. - Now supports
client_credentials.
POST /ad_accounts/{ad_account_id}/audiences
- Added
created_by_company_name.
POST /ad_accounts/{ad_account_id}/audiences/custom
- Added
created_by_company_name.
PATCH /ad_accounts/{ad_account_id}/audiences/ad_accounts/shared
- Added permissions:
CATALOGS_VIEWER,FINANCE_EDIT,FINANCE_VIEW.
PATCH /ad_accounts/{ad_account_id}/audiences/businesses/shared
- Added permissions:
CATALOGS_VIEWER,FINANCE_EDIT,FINANCE_VIEW.
GET /ad_accounts/{ad_account_id}/audiences/shared/accounts
- Now supports
client_credentials.
Promotions
POST /ad_accounts/{ad_account_id}/promotions
- New endpoint for promotion creation.
PATCH /ad_accounts/{ad_account_id}/promotions
- New endpoint for updating promotions.
DELETE /ad_accounts/{ad_account_id}/promotions/{promotion_id}
- New endpoint for deleting promotions.
GET /ad_accounts/{ad_account_id}/promotions/{promotion_id}
- New endpoint for retrieving promotion details.
Conversion Tags
GET /ad_accounts/{ad_account_id}/conversion_tags
- Added support for external measurement ID.
- Now supports
client_credentials.
POST /ad_accounts/{ad_account_id}/conversion_tags
- Added support for external measurement ID.
GET /ad_accounts/{ad_account_id}/conversion_tags/{conversion_tag_id}
- Added support for external measurement ID.
- Now supports
client_credentials.
Catalogs & Product Groups
POST /catalogs/products/get_by_product_group_filters
- Expanded filtering with new custom label operators/types.
- Removed
media_typefrom product pin media.
GET /catalogs/feeds
- Now under
catalog_feedsAPI tag; improved error/warning reporting.
POST /catalogs/feeds
- Now under
catalog_feeds, improved handling of warnings/errors.
PATCH /catalogs/feeds/{feed_id}
- Now under
catalog_feedstag, expanded warnings.
DELETE /catalogs/feeds/{feed_id}
- Now under
catalog_feedstag.
POST /catalogs/feeds/{feed_id}/ingest
- Now under
catalog_feedstag.
GET /catalogs/feeds/{feed_id}
- Now under
catalog_feedstag.
GET /catalogs/feeds/{feed_id}/processing_results
- Now under
catalog_feedstag.
Miscellaneous
GET /businesses/{business_id}/members/{member_id}/assets
- Added
CATALOGasset type, added catalog IDs in response.
GET /businesses/{business_id}/partners/{partner_id}/assets
- Same as above.
PATCH /businesses/{business_id}/partners/assets
- Permissions: added
CATALOGS_VIEWER,FINANCE_EDIT,FINANCE_VIEW.
POST /businesses/{business_id}/requests/assets/access
- Permissions: added
CATALOGS_VIEWER,FINANCE_EDIT,FINANCE_VIEW.
Full Changelog: v5.14.0...v5.15.0