Skip to content
Proud to collaborate with Microsoft for Startups

meta.ads.campaign.enable-with-approval ​

Open a Staff inbox envelope to enable a paused Meta Ads campaign. Does not unpause or spend. Call meta.ads.campaign.enable separately with the approved envelope (v1 still will not set ACTIVE).

Overview ​

PropertyValue
Workflow typeDag
LibraryApp-meta-ads
Version1.0

Input Schema ​

FieldTypeRequiredDefaultDescription
organization_uuidstringYes——
actor_uuidstringYes——
connection_uuidstringNo——
campaign_idstringNo——
ad_account_idstringNo——
reasonstringNo——
suppress_dispatchbooleanNo——

Output Schema ​

FieldTypeRequiredDefaultDescription
failure_reasonstringNo—Engine-stamped human-readable failure reason
failed_atstringNo—ISO timestamp when the workflow failed
failed_at_statestringNo—Engine-stamped state when the workflow failed
failed_stepstringNo—Engine-stamped step name (DAG path)
failed_layerintegerNo—Engine-stamped layer index (DAG path)
errorstringNo—Engine-stamped exception message
error_typestringNo—Engine-stamped exception class name
approval_envelope_uuidstringNo——
approval_envelope_idstringNo——
campaign_idstringNo——
request_reviewjsonNo——

DAG Layers ​

#LayerStepsCompensation
1request_reviewmeta.ads.campaign.request-reviewmeta_ads.compensation.noop

Execution Flow ​

Compensation ​

When any layer fails, its compensation steps run in reverse order to roll back the work completed so far.

Sub-workflows ​

Sub-workflowStep name
meta.ads.campaign.request-reviewrequest_review
meta_ads.compensation.noopabandon_review

Outcomes ​

OutcomeTypeDescriptionState Data Keys
review_requestedSUCCESSInbox review envelope opened; campaign remains pausedapproval_envelope_uuid
failedFAILUREMeta Ads enable-with-approval DAG failedfailure_reason

API Usage ​

bash
POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "meta.ads.campaign.enable-with-approval",
  "initial_data": {
    "organization_uuid": "value",
    "actor_uuid": "value"
  }
}