Pause an ad

Sets the ad to PAUSED on Meta. If the ad has not reached Meta yet, only the Growi record changes and the publish keeps it paused. Needs an owner or admin key.

POST /meta_ads/{id}/pause

cURL

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

200

{
  "success": true,
  "data": {
    "id": 5012,
    "name": "Ava ad",
    "meta_ad_id": "120214567890123456",
    "state": "published",
    "status": "PAUSED",
    "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"
  }
}

Sets the ad to PAUSED on Meta. If the ad has not reached Meta yet, only the Growi record changes and the publish keeps it paused.

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 rejected the pause (PAUSE_FAILED), or the ad was deleted (AD_DELETED)
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/pause" \
     -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "success": true,
  "data": {
    "id": 5012,
    "name": "Ava ad",
    "meta_ad_id": "120214567890123456",
    "state": "published",
    "status": "PAUSED",
    "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"
  }
}

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

Paused

success · boolean

data · object

Show child attributes

error · object

Show child attributes