Update an Ad
Updates an ad’s editable fields.
Authorizations
An account API key, account scoped JWT, app API key, or user OAuth token.
Headers
Pins the request to a dated API version. When omitted, the request uses the original (2025-01-01) request/response shapes, so existing unversioned callers are never broken. Generated SDKs always send the latest version they were built against. An unrecognized value is rejected with a 400. The schemas documented here always describe the latest version.
"2026-06-20"
Path Parameters
The ad ID.
Body
The display name of the ad.
The primary text variants shown in the ad body.
The headline variants shown on the ad.
The description variants shown on the ad.
The call-to-action button shown on the ad.
shop_now, learn_more, sign_up, subscribe, order_now, get_offer, see_details The URL the ad links to.
Query parameters appended to the destination URL, as a string-to-string map.
The ad's creatives. Each entry is an uploaded file id with an optional format; omit format for the original/uncropped asset. Replaces a live ad's creative on the platform.
The social accounts the ad runs under.
Response
ad updated
Clicks divided by impressions, between 0 and 1.
The number of clicks.
Spend divided by clicks; 0 when there are no clicks.
Spend divided by attributed leads; null when leads are not a goal and none are attributed.
Spend per 1,000 impressions; 0 when there are no impressions.
Spend divided by attributed purchases; null when purchases are not a goal and none are attributed.
Platform-reported impressions divided by reach.
The number of impressions.
Whop pixel-attributed leads, last-click.
USD value of pixel-attributed purchases.
Whop pixel-attributed purchases, last-click.
The number of unique people who saw this.
Purchase value divided by spend; 0 when there is no spend.
The amount charged, in spend_currency.
The ISO 4217 currency code of all monetary metrics.
Unique clicks divided by impressions, between 0 and 1.
The number of unique clicks.
Unique identifier for the ad.
The display title of the ad. Falls back to the creative set caption when unset.
The delivery status of the ad.
active, paused, in_review, rejected "active"
The primary text variants shown in the ad body.
The headline variants shown on the ad.
The description variants shown on the ad.
The call-to-action button shown on the ad.
learn_more, shop_now, sign_up, subscribe, get_started, book_now, apply_now, contact_us, download, order_now, buy_now, get_quote, message_page, whatsapp_message, instagram_message, call_now, get_directions, send_updates, get_offer, watch_more, listen_now, play_game, open_link, no_button, get_offer_view, get_event_tickets, see_menu, request_time, event_rsvp, see_details, view_instagram_profile, null "learn_more"
The URL the ad links to.
Query parameters appended to the URL, as a string-to-string map.
The ad group this ad belongs to, an object with an id.
The ad campaign this ad belongs to, an object with an id.
When the ad was created, as an ISO 8601 timestamp.
When the ad was last updated, as an ISO 8601 timestamp.

