Launch an ad

Turns a published ad on, with its ad set and campaign. An ad that is still publishing launches as soon as it publishes (deferred: true). Already active ads are left as they are. Needs an owner or admin key.

POST /meta_ads/{id}/launch

cURL

curl -X POST "https://api.growi.io/api/public/v1/meta_ads/5012/launch" \
     -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "success": true,
  "data": {
    "id": 5012,
    "name": "Ava ad",
    "meta_ad_id": "120214567890123456",
    "state": "active",
    "status": "ACTIVE",
    "published": true,
    "failed": false,
    "error_message": null,
    "last_step": "ad",
    "meta_ad_set_id": 78552828,
    "meta_ad_set_name": "Broad US",
    "campaign_affiliate_id": 3490313,
    "external": false,
    "created_at": "2026-10-14T13:05:11Z",
    "deferred": false
  }
}

Turns an ad on, with its ad set and campaign, and starts spend. An ad that is still publishing launches as soon as it publishes (deferred: true). An ad that is already active is left as it is.

Step 5 of the Meta ads automation flow. You do not need this call for ads created with launch_state: "active".

Authentication

Needs a full-access API key whose creator is an owner or admin. Legacy keys that are not tied to a person also work. View-only keys, and keys whose creator has the viewer role, get 403. See Rate limits and authentication.

Errors

Status	When
401	Missing or invalid API key, or the person who created the key is no longer an owner, admin or viewer of the organization
403	View-only API key, or the key’s user is not an owner or admin
404	No ad with this id in your organization, or organization_id is not a child brand of the key’s organization
422	Meta refused the launch, or the ad was deleted (AD_DELETED). data shows the ad as it is now.
429	Rate limited: 2 seconds between requests, and 40 requests per hour per key by default

cURL

curl -X POST "https://api.growi.io/api/public/v1/meta_ads/5012/launch" \
     -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "success": true,
  "data": {
    "id": 5012,
    "name": "Ava ad",
    "meta_ad_id": "120214567890123456",
    "state": "active",
    "status": "ACTIVE",
    "published": true,
    "failed": false,
    "error_message": null,
    "last_step": "ad",
    "meta_ad_set_id": 78552828,
    "meta_ad_set_name": "Broad US",
    "campaign_affiliate_id": 3490313,
    "external": false,
    "created_at": "2026-10-14T13:05:11Z",
    "deferred": false
  }
}

Authorizations

Authorization · string · header · required

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

Path Parameters

id · integer · required

Growi ad id

Query Parameters

organization_id · integer

Act on a child brand of the API key's organization. Omit it to act on the key's own organization. Any other id returns 404.

Response

200

application/json

Launched, or queued to launch after publish

success · boolean

data · object

Show child attributes

error · object

Show child attributes