Meta Ads

Add a paused ad to a Meta ad set

Creates one ad, PAUSED, inside an ad set that already exists. The creative is either one that already exists (creative_id) or a new single-image creative built from image_url plus copy. Use when: the user wants another ad in an ad set — a new creative to test, or the same creative reused in a second audience. Do not use to create a campaign or an ad set; meta_create_image_campaign and meta_add_ad_set do that. Do not pass both creative_id and image_url: reusing a creative and making one are different intentions and the tool will not guess. Returns the new ad id (and the creative id when one was created) and reads the ad back so the paused status is confirmed. If the user has not said which ad set, ask. Adding an ad to the wrong ad set puts it in front of the wrong audience.

post/api/v1/tools/meta_add_ad/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/meta_add_ad/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.