Ad Campaign

An Ad Campaign is the top-level container for paid ads on an ad network. It sets the platform, objective, and budget strategy shared by its ad groups and ads. Use the Ad Campaigns API to create campaigns, list campaigns for an account, retrieve or update campaign settings, and pause or resume campaign delivery.

Endpoints

Endpoint	Request
List Ad Campaigns	GET `/ad_campaigns`
Create Ad Campaign	POST `/ad_campaigns`
Retrieve Ad Campaign	GET `/ad_campaigns/{id}`
Update Ad Campaign	PATCH `/ad_campaigns/{id}`
Delete Ad Campaign	DELETE `/ad_campaigns/{id}`
Pause Ad Campaign	POST `/ad_campaigns/{id}/pause`
Unpause Ad Campaign	POST `/ad_campaigns/{id}/unpause`

Attributes

string

required

Unique identifier for the ad campaign, prefixed adcamp_.

added_to_cart_value

number

required

USD value attributed to add-to-cart events. Sums the value sent with each event, normalized to USD; events without a value contribute 0.

added_to_carts

number

required

Whop pixel-attributed add-to-cart events, last-click.

bid_type

string | null

required

How delivery bids in the ad auction: minimum_cost gets the most results for the budget, average_target holds an average cost per result, and maximum_target never bids above a cap.Available options: minimum_cost, average_target, maximum_target

budget_amount

number | null

required

The campaign’s budget, in the ad account’s currency. null when each ad group sets its own budget instead.

budget_optimization

string | null

required

Which level owns the budget: the whole campaign (ad_campaign) or each ad group individually (ad_group).Available options: ad_campaign, ad_group

budget_type

string | null

required

Whether budget_amount is spent per day (daily) or over the campaign’s full run (lifetime).Available options: daily, lifetime

click_through_rate

number

required

Clicks divided by impressions, between 0 and 1.

clicks

number

required

The number of clicks.

completed_registration_value

number

required

USD value attributed to complete-registration events. Sums the value sent with each event, normalized to USD; events without a value contribute 0.

completed_registrations

number

required

Whop pixel-attributed complete-registration events, last-click.

contact_value

number

required

USD value attributed to contact events. Sums the value sent with each event, normalized to USD; events without a value contribute 0.

contacts

number

required

Whop pixel-attributed contact events, last-click.

cost_per_added_to_cart

number | null

required

Spend divided by attributed add-to-cart events; null when they are not the goal and none are attributed.

cost_per_click

number

required

Spend divided by clicks; 0 when there are no clicks.

cost_per_completed_registration

number | null

required

Spend divided by attributed complete-registration events; null when they are not the goal and none are attributed.

cost_per_contact

number | null

required

Spend divided by attributed contact events; null when contacts are not the goal and none are attributed.

cost_per_lead

number | null

required

Spend divided by attributed leads; null when leads are not a goal and none are attributed.

cost_per_mille

number

required

Spend per 1,000 impressions; 0 when there are no impressions.

cost_per_purchase

number | null

required

Spend divided by attributed purchases; null when purchases are not a goal and none are attributed.

cost_per_result

number | null

required

Spend divided by Whop pixel-attributed results; null when nothing Whop-attributable is being optimized for.

cost_per_schedule

number | null

required

Spend divided by attributed schedule events; null when schedules are not the goal and none are attributed.

cost_per_submitted_application

number | null

required

Spend divided by attributed submit-application events; null when they are not the goal and none are attributed.

cost_per_unique_click

number | null

required

Spend divided by unique clicks; null when there are no unique clicks.

cost_per_viewed_content

number | null

required

Spend divided by attributed view-content events; null when they are not the goal and none are attributed.

created_at

string

required

When the campaign was created, as an ISO 8601 timestamp.

custom_conversions

number

required

Whop pixel-attributed custom (merchant-defined) conversion events, last-click, across all custom event names.

custom_event_counts

object

required

Whop pixel-attributed custom conversions, keyed by your event name with its last-click count as the value. Empty when no named custom events are attributed. Custom events fired without a name are counted in custom_conversions but omitted here, so these values sum to at most custom_conversions.

custom_event_values

object

required

Conversion value attributed to each custom event, keyed by event name like custom_event_counts. Sums the value passed to whop.track, normalized to USD; events fired without a value contribute 0.

delivery_status

string

required

Whether the campaign’s ads are delivering right now, and if not, why. When several states apply at once, the highest-precedence one is returned.Available options: payment_failed, all_ads_rejected, draft, no_ad_groups, no_ads, paused, processing, issues, scheduled, completed, ad_groups_off, active

frequency

number | null

required

Platform-reported impressions divided by reach.

impressions

number

required

The number of impressions.

issues

object[]

required

Open issues affecting the campaign and its descendant ad groups and ads.

Properties

string

required

Unique identifier for the issue.

message

string

required

A description of what the issue is and how it can be resolved.

resource_id

string | null

required

The ID of the campaign, ad group, or ad the issue is attached to.

resource_type

string

required

The type of resource the issue is attached to.Available options: ad_campaign, ad_group, ad

lead_value

number

required

USD value attributed to lead events. Sums the value sent with each event, normalized to USD; events without a value contribute 0.

leads

number

required

Whop pixel-attributed leads, last-click.

objective

string | null

required

The goal the campaign optimizes toward.Available options: awareness, traffic, engagement, leads, sales

optimization_goal

string | null

required

The event the campaign optimizes for when a single goal is set campaign-wide. null when each ad group sets its own optimization_goal.

platform

string

required

The ad network the campaign runs on.Available options: meta

purchase_value

number

required

USD value of pixel-attributed purchases.

purchases

number

required

Whop pixel-attributed purchases, last-click.

reach

number

required

The number of unique people who saw this.

result_event

string | null

required

The Whop pixel conversion event whose attributed count represents results — the optimization goal, or the highest-volume attributed event for campaigns that budget per ad group. Null when the goal isn’t a Whop-attributed event.Available options: purchase, lead, schedule, submit_application, contact, complete_registration, view_content, add_to_cart, custom

result_event_name

string | null

required

The merchant-defined event name when result_event is custom; null for the standard events.

results

number | null

required

The Whop pixel-attributed count behind result_event. When a campaign’s ad groups optimize different goals there is no single result_event (it is null), and this is instead the sum of each ad group’s own attributed results. Null when nothing Whop-attributable is being optimized for.

return_on_ad_spend

number

required

Purchase value divided by spend, both in USD (a currency-neutral ratio); 0 when there is no spend.

schedule_value

number

required

USD value attributed to schedule events. Sums the value sent with each event, normalized to USD; events without a value contribute 0.

schedules

number

required

Whop pixel-attributed schedule events, last-click.

special_ad_categories

string[]

required

Regulated categories the campaign is declared under. Ads in these categories are subject to extra targeting restrictions. Empty when none apply.

spend

number

required

The amount charged, in spend_currency.

spend_currency

string | null

required

The ISO 4217 currency code of all monetary metrics.

status

string

required

The lifecycle status of the ad campaign.Available options: active, paused, inactive, stale, pending_refund, payment_failed, draft, in_review, flagged, importing, imported

submitted_application_value

number

required

USD value attributed to submit-application events. Sums the value sent with each event, normalized to USD; events without a value contribute 0.

submitted_applications

number

required

Whop pixel-attributed submit-application events, last-click.

title

string

required

Display name of the ad campaign.

unique_click_through_rate

number | null

required

Unique clicks divided by impressions, between 0 and 1.

unique_clicks

number

required

People who clicked, reported by the Whop pixel, counted once per person.

updated_at

string

required

When the campaign was last updated, as an ISO 8601 timestamp.

viewed_content_value

number

required

USD value attributed to view-content events. Sums the value sent with each event, normalized to USD; events without a value contribute 0.

viewed_contents

number

required

Whop pixel-attributed view-content events, last-click.

AdCampaign

{
	"id": "adcamp_xxxxxxxxxx",
	"added_to_cart_value": 2100,
	"added_to_carts": 42,
	"bid_type": "minimum_cost",
	"budget_amount": 250,
	"budget_optimization": "ad_campaign",
	"budget_type": "daily",
	"click_through_rate": 0.032,
	"clicks": 1200,
	"completed_registration_value": 0,
	"completed_registrations": 28,
	"contact_value": 0,
	"contacts": 18,
	"cost_per_added_to_cart": 17.86,
	"cost_per_click": 0.63,
	"cost_per_completed_registration": 26.79,
	"cost_per_contact": 41.67,
	"cost_per_lead": 30,
	"cost_per_mille": 20,
	"cost_per_purchase": 50,
	"cost_per_result": 50,
	"cost_per_schedule": null,
	"cost_per_submitted_application": null,
	"cost_per_unique_click": 0.74,
	"cost_per_viewed_content": 1.25,
	"created_at": "2026-06-01T12:00:00Z",
	"custom_conversions": 10,
	"custom_event_counts": {
		"QualifiedCall": 7,
		"BookedDemo": 3
	},
	"custom_event_values": {
		"QualifiedCall": 3500,
		"BookedDemo": 0
	},
	"delivery_status": "issues",
	"frequency": 2.1,
	"impressions": 37500,
	"issues": [
		{
			"id": "adiss_xxxxxxxxxxx",
			"message": "The ad's creative violates the ad network's policies. Edit the creative and resubmit for review.",
			"resource_id": "adcamp_xxxxxxxxxx",
			"resource_type": "ad_campaign"
		}
	],
	"lead_value": 1250,
	"leads": 25,
	"objective": "sales",
	"optimization_goal": "purchase",
	"platform": "meta",
	"purchase_value": 12600,
	"purchases": 15,
	"reach": 17800,
	"result_event": "purchase",
	"result_event_name": null,
	"results": 15,
	"return_on_ad_spend": 16.8,
	"schedule_value": 0,
	"schedules": 0,
	"special_ad_categories": [],
	"spend": 750,
	"spend_currency": "usd",
	"status": "active",
	"submitted_application_value": 0,
	"submitted_applications": 0,
	"title": "Pickaxe Pro launch",
	"unique_click_through_rate": 0.027,
	"unique_clicks": 1010,
	"updated_at": "2026-06-02T12:00:00Z",
	"viewed_content_value": 0,
	"viewed_contents": 600
}

Introduction

Reference

Core Resources

Money

Commerce

Partners

Workforce

Tracking

Ads

Media

Identity

Developer

Endpoints

Attributes

​Endpoints

​Attributes

Endpoints

Attributes