import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: "YOUR_TOKEN", apiVersionDate: "2026-08-21-1", idempotencyKey: "YOUR_IDEMPOTENCY_KEY" });
await client.ads.create();

curl --request POST \
  --url https://api.whop.com/api/v1/ads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ad_group": {
    "ad_campaign_id": "adcamp_xxxxxxxxxxxxxx",
    "budget_amount": 60,
    "budget_type": "daily",
    "title": "Austin — ceramic coating buyers"
  },
  "ad_group_id": "adgrp_xxxxxxxxxxxxxx",
  "call_to_action": "shop_now",
  "creatives": [
    {
      "crop": {
        "height": 1000,
        "width": 1000,
        "x": 40,
        "y": 0
      },
      "format": "square",
      "id": "file_xxxxxxxxxxxxxx"
    }
  ],
  "descriptions": [
    {
      "text": "Two-stage paint correction included"
    }
  ],
  "headlines": [
    {
      "text": "Showroom shine, guaranteed"
    }
  ],
  "primary_texts": [
    {
      "text": "Three-year ceramic coating, booked online in under a minute."
    }
  ],
  "title": "Ceramic coating — spring hook",
  "url": "https://shinetime.example/ceramic-coating",
  "url_parameters": {
    "ref": "spring"
  }
}
'

import requests

url = "https://api.whop.com/api/v1/ads"

payload = {
    "ad_group": {
        "ad_campaign_id": "adcamp_xxxxxxxxxxxxxx",
        "budget_amount": 60,
        "budget_type": "daily",
        "title": "Austin — ceramic coating buyers"
    },
    "ad_group_id": "adgrp_xxxxxxxxxxxxxx",
    "call_to_action": "shop_now",
    "creatives": [
        {
            "crop": {
                "height": 1000,
                "width": 1000,
                "x": 40,
                "y": 0
            },
            "format": "square",
            "id": "file_xxxxxxxxxxxxxx"
        }
    ],
    "descriptions": [{ "text": "Two-stage paint correction included" }],
    "headlines": [{ "text": "Showroom shine, guaranteed" }],
    "primary_texts": [{ "text": "Three-year ceramic coating, booked online in under a minute." }],
    "title": "Ceramic coating — spring hook",
    "url": "https://shinetime.example/ceramic-coating",
    "url_parameters": { "ref": "spring" }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    ad_group: {
      ad_campaign_id: 'adcamp_xxxxxxxxxxxxxx',
      budget_amount: 60,
      budget_type: 'daily',
      title: 'Austin — ceramic coating buyers'
    },
    ad_group_id: 'adgrp_xxxxxxxxxxxxxx',
    call_to_action: 'shop_now',
    creatives: [
      {
        crop: {height: 1000, width: 1000, x: 40, y: 0},
        format: 'square',
        id: 'file_xxxxxxxxxxxxxx'
      }
    ],
    descriptions: [{text: 'Two-stage paint correction included'}],
    headlines: [{text: 'Showroom shine, guaranteed'}],
    primary_texts: [{text: 'Three-year ceramic coating, booked online in under a minute.'}],
    title: 'Ceramic coating — spring hook',
    url: 'https://shinetime.example/ceramic-coating',
    url_parameters: {ref: 'spring'}
  })
};

fetch('https://api.whop.com/api/v1/ads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/ads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'ad_group' => [
        'ad_campaign_id' => 'adcamp_xxxxxxxxxxxxxx',
        'budget_amount' => 60,
        'budget_type' => 'daily',
        'title' => 'Austin — ceramic coating buyers'
    ],
    'ad_group_id' => 'adgrp_xxxxxxxxxxxxxx',
    'call_to_action' => 'shop_now',
    'creatives' => [
        [
                'crop' => [
                                'height' => 1000,
                                'width' => 1000,
                                'x' => 40,
                                'y' => 0
                ],
                'format' => 'square',
                'id' => 'file_xxxxxxxxxxxxxx'
        ]
    ],
    'descriptions' => [
        [
                'text' => 'Two-stage paint correction included'
        ]
    ],
    'headlines' => [
        [
                'text' => 'Showroom shine, guaranteed'
        ]
    ],
    'primary_texts' => [
        [
                'text' => 'Three-year ceramic coating, booked online in under a minute.'
        ]
    ],
    'title' => 'Ceramic coating — spring hook',
    'url' => 'https://shinetime.example/ceramic-coating',
    'url_parameters' => [
        'ref' => 'spring'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.whop.com/api/v1/ads"

	payload := strings.NewReader("{\n  \"ad_group\": {\n    \"ad_campaign_id\": \"adcamp_xxxxxxxxxxxxxx\",\n    \"budget_amount\": 60,\n    \"budget_type\": \"daily\",\n    \"title\": \"Austin — ceramic coating buyers\"\n  },\n  \"ad_group_id\": \"adgrp_xxxxxxxxxxxxxx\",\n  \"call_to_action\": \"shop_now\",\n  \"creatives\": [\n    {\n      \"crop\": {\n        \"height\": 1000,\n        \"width\": 1000,\n        \"x\": 40,\n        \"y\": 0\n      },\n      \"format\": \"square\",\n      \"id\": \"file_xxxxxxxxxxxxxx\"\n    }\n  ],\n  \"descriptions\": [\n    {\n      \"text\": \"Two-stage paint correction included\"\n    }\n  ],\n  \"headlines\": [\n    {\n      \"text\": \"Showroom shine, guaranteed\"\n    }\n  ],\n  \"primary_texts\": [\n    {\n      \"text\": \"Three-year ceramic coating, booked online in under a minute.\"\n    }\n  ],\n  \"title\": \"Ceramic coating — spring hook\",\n  \"url\": \"https://shinetime.example/ceramic-coating\",\n  \"url_parameters\": {\n    \"ref\": \"spring\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.whop.com/api/v1/ads")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ad_group\": {\n    \"ad_campaign_id\": \"adcamp_xxxxxxxxxxxxxx\",\n    \"budget_amount\": 60,\n    \"budget_type\": \"daily\",\n    \"title\": \"Austin — ceramic coating buyers\"\n  },\n  \"ad_group_id\": \"adgrp_xxxxxxxxxxxxxx\",\n  \"call_to_action\": \"shop_now\",\n  \"creatives\": [\n    {\n      \"crop\": {\n        \"height\": 1000,\n        \"width\": 1000,\n        \"x\": 40,\n        \"y\": 0\n      },\n      \"format\": \"square\",\n      \"id\": \"file_xxxxxxxxxxxxxx\"\n    }\n  ],\n  \"descriptions\": [\n    {\n      \"text\": \"Two-stage paint correction included\"\n    }\n  ],\n  \"headlines\": [\n    {\n      \"text\": \"Showroom shine, guaranteed\"\n    }\n  ],\n  \"primary_texts\": [\n    {\n      \"text\": \"Three-year ceramic coating, booked online in under a minute.\"\n    }\n  ],\n  \"title\": \"Ceramic coating — spring hook\",\n  \"url\": \"https://shinetime.example/ceramic-coating\",\n  \"url_parameters\": {\n    \"ref\": \"spring\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/ads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ad_group\": {\n    \"ad_campaign_id\": \"adcamp_xxxxxxxxxxxxxx\",\n    \"budget_amount\": 60,\n    \"budget_type\": \"daily\",\n    \"title\": \"Austin — ceramic coating buyers\"\n  },\n  \"ad_group_id\": \"adgrp_xxxxxxxxxxxxxx\",\n  \"call_to_action\": \"shop_now\",\n  \"creatives\": [\n    {\n      \"crop\": {\n        \"height\": 1000,\n        \"width\": 1000,\n        \"x\": 40,\n        \"y\": 0\n      },\n      \"format\": \"square\",\n      \"id\": \"file_xxxxxxxxxxxxxx\"\n    }\n  ],\n  \"descriptions\": [\n    {\n      \"text\": \"Two-stage paint correction included\"\n    }\n  ],\n  \"headlines\": [\n    {\n      \"text\": \"Showroom shine, guaranteed\"\n    }\n  ],\n  \"primary_texts\": [\n    {\n      \"text\": \"Three-year ceramic coating, booked online in under a minute.\"\n    }\n  ],\n  \"title\": \"Ceramic coating — spring hook\",\n  \"url\": \"https://shinetime.example/ceramic-coating\",\n  \"url_parameters\": {\n    \"ref\": \"spring\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "ad_campaign": {
    "id": "adcamp_xxxxxxxxxxxxxx"
  },
  "ad_group": {
    "id": "adcamp_xxxxxxxxxxxxxx"
  },
  "added_to_cart_value": 1850,
  "added_to_carts": 74,
  "call_to_action": "learn_more",
  "click_through_rate": 0.0261,
  "clicks": 1337,
  "completed_registration_value": 95,
  "completed_registrations": 19,
  "contact_value": 175,
  "contacts": 27,
  "content_review": {
    "networks": [
      {
        "recommended": true,
        "title": "whop"
      }
    ],
    "status": "not_reviewed",
    "tags": [
      {
        "message": "<string>",
        "title": "<string>"
      }
    ]
  },
  "cost_per_added_to_cart": 6.515675675675676,
  "cost_per_click": 0.36,
  "cost_per_completed_registration": 25.37684210526316,
  "cost_per_contact": 17.85777777777778,
  "cost_per_lead": 3.984793388429752,
  "cost_per_mille": 9.42,
  "cost_per_purchase": 12.68842105263158,
  "cost_per_result": 7.653333333333333,
  "cost_per_schedule": 10.48173913043478,
  "cost_per_submitted_application": 40.18,
  "cost_per_unique_click": 0.48,
  "cost_per_viewed_content": 0.2253084112149533,
  "created_at": "2026-01-01T12:00:00.000Z",
  "creatives": [
    {
      "crop": {
        "height": 1000,
        "width": 1000,
        "x": 40,
        "y": 0
      },
      "format": "vertical",
      "id": "file_xxxxxxxxxxxxxx",
      "language": null,
      "media_type": "image",
      "url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }
  ],
  "custom_conversions": 63,
  "custom_event_counts": {
    "booked_detail": 63
  },
  "custom_event_values": {
    "booked_detail": 4820
  },
  "delivery_status": "paused",
  "descriptions": [
    {
      "language": null,
      "text": "Austin's mobile detailers"
    }
  ],
  "frequency": null,
  "headlines": [
    {
      "language": null,
      "text": "Austin's mobile detailers"
    }
  ],
  "id": "ad_xxxxxxxxxxxxxx",
  "impressions": 51204,
  "issues": [
    {
      "category": "error",
      "id": "adiss_xxxxxxxxxxxxxx",
      "message": "Your ad didn't pass our content review. Update it to follow our ad guidelines and resubmit.",
      "resource_id": "ad_xxxxxxxxxxxxxx",
      "resource_type": "ad",
      "title": "Ad issue"
    }
  ],
  "lead_value": 1180,
  "leads": 121,
  "link_clicks": 1071,
  "primary_texts": [
    {
      "language": null,
      "text": "Austin's mobile detailers"
    }
  ],
  "purchase_value": 9462,
  "purchases": 38,
  "reach": 0,
  "result_event": "custom",
  "result_event_name": "booked_detail",
  "results": 63,
  "return_on_ad_spend": 19.62419113987058,
  "schedule_value": 640,
  "schedules": 46,
  "spend": 482.16,
  "spend_currency": "usd",
  "status": "paused",
  "submitted_application_value": 300,
  "submitted_applications": 12,
  "title": "Ceramic coating — spring hook v2",
  "unique_click_through_rate": null,
  "unique_clicks": 1012,
  "updated_at": "2026-01-01T12:00:00.000Z",
  "url": "https://shinetime.example/ceramic-coating",
  "url_parameters": {},
  "viewed_content_value": 0,
  "viewed_contents": 2140
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}