Skip to main content
POST
Create a ChatGPT ad group

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Optional caller-generated value that prevents duplicate generation when retrying the same request.

Required string length: 1 - 255

Body

application/json
product_id
string<uuid>
required
target_url
string<uri>
required

The landing page every ad in the group links to.

Maximum string length: 2048
angle
string

Optional direction for the ads. It also names the group.

Required string length: 1 - 2000
price
string
Required string length: 1 - 100
Example:

"$89"

ad_count
enum<integer>
default:3
Available options:
1,
3,
5,
8
max_credits
integer

Refuse the request with 422 credit_limit_exceeded, before anything is charged, if it would cost more than this many credits.

Required range: x >= 1

Response

Ad group accepted.

id
string<uuid>
required
product_id
string<uuid>
required
name
string | null
required
target_url
string<uri> | null
required
angle
string | null
required
price
string | null
required
context_hints
string[]
required

Shared by every ad in the group. Empty until the copy is written.

negative_phrases
string[]
required
status
enum<string>
required
Available options:
in_progress,
completed,
failed
credits_charged
integer
required

Net credits charged so far. Refunds for failed renders are subtracted.

ads
object[]
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
Last modified on September 30, 2026