Campaigns / REST API
Launch prepared campaign
Activate a campaign that was prepared by prepare-campaign-launch. Requires the exact expiring approvalId and confirm=true. Revalidates workspace ownership and campaign draft status, atomically consumes the approval, and starts delivery idempotently.
POST /api/v1/strategy/launch-prepared-campaignDeterministic operationParameters
workspaceIdOptional · string- Optional with API-key auth. Inferred from the key.
approvalIdRequired · string- Approval ID returned by prepare-campaign-launch.
confirmRequired · boolean- Must be true after the operator explicitly approves the preview.
curl -X POST "https://app.pipeline.help/api/v1/strategy/launch-prepared-campaign" \
-H "Authorization: Bearer $PIPELINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"approvalId":"00000000-0000-4000-8000-000000000000","confirm":true}'Full input schema
{
"type": "object",
"properties": {
"workspaceId": {
"type": "string",
"description": "Optional with API-key auth. Inferred from the key."
},
"approvalId": {
"type": "string",
"description": "Approval ID returned by prepare-campaign-launch."
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true after the operator explicitly approves the preview."
}
},
"required": [
"approvalId",
"confirm"
]
}