Skip to main content
POST
/
ads
Create ad
curl --request POST \
  --url https://api.whop.com/api/v1/ads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ad_group_id": "<string>",
  "creative_set_id": "<string>",
  "platform_config": {
    "meta": {
      "name": "<string>",
      "link_url": "<string>",
      "url_tags": "<string>",
      "primary_text": "<string>",
      "headline": "<string>",
      "call_to_action_type": "LEARN_MORE",
      "page_id": "<string>",
      "instagram_actor_id": "<string>"
    },
    "tiktok": {
      "ad_name": "<string>",
      "ad_format": "SINGLE_IMAGE",
      "identity_type": "CUSTOMIZED_USER",
      "identity_id": "<string>",
      "identity_authorized_bc_id": "<string>",
      "video_id": "<string>",
      "image_ids": [
        "<string>"
      ],
      "ad_text": "<string>",
      "call_to_action": "<string>",
      "landing_page_url": "<string>"
    }
  },
  "status": "active"
}
'
{
  "id": "xad_xxxxxxxxxxxxxx",
  "status": "active",
  "created_at": "2023-12-01T05:00:00.401Z",
  "updated_at": "2023-12-01T05:00:00.401Z",
  "platform_config": {
    "typename": "<string>",
    "platform": "meta",
    "name": "<string>",
    "link_url": "<string>",
    "url_tags": "<string>",
    "primary_text": "<string>",
    "headline": "<string>",
    "call_to_action_type": "LEARN_MORE",
    "page_id": "<string>",
    "instagram_actor_id": "<string>"
  },
  "external_ad_group": {
    "id": "adgrp_xxxxxxxxxxxx",
    "name": "<string>",
    "status": "active"
  },
  "external_ad_creative_set": {
    "id": "adcs_xxxxxxxxxxxxx"
  }
}

Authorizations

​
Authorization
string
header
required

A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************

Body

application/json

Parameters for CreateAd

​
ad_group_id
string
required

The unique identifier of the ad group to create this ad in.

​
creative_set_id
string | null

The unique identifier of the creative set to use.

​
platform_config
object

Platform-specific configuration. Must match the campaign platform.

​
status
enum<string> | null

Initial status (defaults to active).

Available options:
active,
paused,
inactive

Response

A successful response

An ad belonging to an ad group

​
id
string
required

Unique identifier for the ad.

Example:

"xad_xxxxxxxxxxxxxx"

​
status
enum<string>
required

Current status of the ad.

Available options:
active,
paused,
inactive
​
created_at
string<date-time>
required

When the ad was created.

Example:

"2023-12-01T05:00:00.401Z"

​
updated_at
string<date-time>
required

When the ad was last updated.

Example:

"2023-12-01T05:00:00.401Z"

​
platform_config
MetaAdPlatformConfigType · object
required

Meta (Facebook/Instagram) ad configuration.

​
external_ad_group
object
required

The parent ad group.

​
external_ad_creative_set
object
required

The creative set used by this ad.