Ads

Pause and activate campaigns, ad sets and ads via API

Turning ads on and off is a PATCH with status active or paused, at the level you want to control: campaign, ad set or ad. It works for any object in the connected account, including those created directly in Ads Manager. No Meta API to implement.

The request

PATCH /api/ads/campaigns/{id}?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "status": "active"
}

What you can do

  • Pause or activate a campaign with PATCH /ads/campaigns/{id}.
  • Pause or activate an ad set with PATCH /ads/adsets/{id}.
  • Pause or activate an ad with PATCH /ads/{id}.
  • Change the name in the same PATCH.
  • Identify the object by the platform id or by the Connect uuid.

Rules and limits

  • Accepted status values: active and paused.
  • Works for any object in the account, including those created outside Connect: it is stored on the first write.
  • Idempotency-Key is optional on PATCH.
  • The id is checked against the connection's account; from another account, the response is 404 ads_object_not_found.
  • The connection in customer_integration must belong to the customer (403 otherwise) and be valid (422 ads_connection_expired if the token expired).
  • The response is synchronous (200).

Main fields

FieldTypeRequiredDescription
idstringYesIn the path: the object's id (or the Connect uuid).
statusstringNoactive or paused.
namestringNoNew name, if you want to change it at the same time.
customer_integrationstringYesIn the query: the client's connection to the ad account.
Idempotency-KeystringNoIn the header. Optional on PATCH, recommended so you can retry safely.

Who it is for

  • On/off switch in the dashboard

    Your client pauses a campaign right in your product, without opening Ads Manager.

  • Automatic safety rule

    Pause ads when a metric passes a threshold you define, such as a high cost per result.

  • AI agent that manages budget

    The agent pauses what underperforms and activates what was approved, all through simple calls.

Works with

  • Meta Ads

Frequently asked questions

Do I need to have created the ad through Connect to pause it?

No. Any object in the connected account can be paused or activated; it enters Connect's records on the first write.

Which status values are accepted?

active and paused.

Can I safely repeat the call?

Yes. Send an Idempotency-Key (optional on PATCH) and a repeat with the same key returns the first response.

Related

See everything you can do with Ads

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.