ChatGPT Ads

Create a ChatGPT Ads ad group

Adds one paused ad group to a campaign that already exists, with its own bidding configuration and optional context hints. Nothing delivers until the user resumes it, and creating it spends nothing. Use when: the user wants to test a different audience, context or bid inside a campaign they already have. Get the campaign id from chatgpt_list_campaigns first. Do not use it to set a budget — budgets live on the campaign on this platform, so a "budget for this ad group" is really chatgpt_update_campaign. Do not use it to build a whole campaign from scratch: that is chatgpt_launch_ad. Do not pass a place name in geo_location_ids. Resolve every place with chatgpt_geo_lookup first; ids only. Because geo targeting is a campaign setting here, passing locations rewrites where the whole campaign runs — the preview says so explicitly, so read it to the user before they approve. max_bid is required: this tool creates a fixed-bid ad group, which the platform will not accept without a maximum bid, so a call without one is refused before anything is created. Its unit follows the campaign objective — a CPM (per 1,000 impressions) for reach, per click for clicks, per conversion for conversions — and the preview shows it with that unit. Returns the new ad group id, read back from the platform with its paused state and its bid confirmed. If the user has not said what the ad group is for or what to bid, ask. Do not invent a bid.

post/api/v1/tools/chatgpt_create_ad_group/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/chatgpt_create_ad_group/execute
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional 8-128 character key. A successful envelope is cached for 24 hours; replaying the key with the same arguments returns it again with Idempotent-Replayed: true, and replaying it with different arguments answers 409.

Request body

Response

The tool ran. A write returns proposal_id and approve_url while the change waits for approval.

successunknown required
toolstring required
dataobject required

Machine-readable result.

markdownstring required

The same result written for a person or a model.

proposal_idstring

Present for writes. Nothing changes on the ad platform until it is approved.

approve_urlstring

Where a person approves the proposal.

request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.