---
title: "Changes to Create an Ad"
method: POST
path: "/ads"
---

# Changes to Create an Ad

`POST /ads`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 42 revisions.

- **2026-08-27** `16c82685be35` — 1 info
- **2026-08-25** `621705ee8f4a` — 1 warning, 2 info
- **2026-08-20** `4a1a4a5d2c72` — 1 warning
- **2026-08-15** `c301132dbfd7` — 1 warning
- **2026-08-12** `ae20b30817de` — 1 info
- **2026-08-07** `f1020c3ecda4` — 2 info
- **2026-07-26** `60bbb4a6ffbc` — 8 breaking, 11 info
- **2026-07-14** `3a06a605784b` — 2 info

## Changes

- **2026-08-27** `16c82685be35` — 1 info
  - added the required property `link_clicks` to the response with the `200` status
- **2026-08-25** `621705ee8f4a` — 1 warning, 2 info
  - removed the request property `post_id`
  - added the new optional request property `existing_post_id`
  - added the required property `existing_post_id` to the response with the `200` status
- **2026-08-20** `4a1a4a5d2c72` — 1 warning
  - added the new `scheduled` enum value to the `delivery_status` response property for the response status `200`
- **2026-08-15** `c301132dbfd7` — 1 warning
  - added the new `messaging_conversation` enum value to the `result_event` response property for the response status `200`
- **2026-08-12** `ae20b30817de` — 1 info
  - added the non-success response with the status `409`
- **2026-08-07** `f1020c3ecda4` — 2 info
  - added the optional property `error/code` to the response with the `400` status
  - added the optional property `error/code` to the response with the `404` status
- **2026-07-26** `60bbb4a6ffbc` — 8 breaking, 11 info
  - the response property `lead_form` became optional for the status `200`
  - the response property `lead_form_id` became optional for the status `200`
  - the response property `messaging_config` became optional for the status `200`
  - the response property `multi_advertiser_ads` became optional for the status `200`
  - added `#/components/schemas/AdLeadForm, subschema #2` to the `lead_form` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/AdMessagingConfig, subschema #2` to the `messaging_config` response property `oneOf` list for the response status `200`
  - the `lead_form` response's property type/format changed from `object, null`/`` to ``/`` for status `200`
  - the `messaging_config` response's property type/format changed from `object, null`/`` to ``/`` for status `200`
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the required property `added_to_cart_value` to the response with the `200` status
  - added the required property `completed_registration_value` to the response with the `200` status
  - added the required property `contact_value` to the response with the `200` status
  - added the required property `cost_per_unique_click` to the response with the `200` status
  - added the required property `custom_event_values` to the response with the `200` status
  - added the required property `lead_value` to the response with the `200` status
  - added the required property `schedule_value` to the response with the `200` status
  - added the required property `social_accounts/items/id` to the response with the `200` status
  - added the required property `submitted_application_value` to the response with the `200` status
  - added the required property `viewed_content_value` to the response with the `200` status
- **2026-07-14** `3a06a605784b` — 2 info
  - added the required property `custom_event_counts` to the response with the `200` status
  - added the required property `results` to the response with the `200` status

---

[Operation](https://skmtc.dev/whop/apis/whop-api/docs/ads/post.md) · [API](https://skmtc.dev/whop/apis/whop-api.md) · [Page](https://skmtc.dev/whop/apis/whop-api/changes/ads/post)