curl -X PATCH "https://api.nedzo.ai/v1/campaigns/123e4567-e89b-12d3-a456-426614174000" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "status": "live" }'
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"workspaceId": "789e4567-e89b-12d3-a456-426614174000",
"name": "September promo",
"voiceAgentId": "aaa11111-bbbb-2222-cccc-333344445555",
"savedViewId": "bbb11111-bbbb-2222-cccc-333344445555",
"dailyCapTalkMinutes": 120,
"maxFollowUps": 2,
"callingDays": [1, 2, 3, 4, 5],
"callingHoursStart": "09:00:00",
"callingHoursEnd": "17:00:00",
"callingTimezone": null,
"status": "live",
"createdAt": "2026-10-11T12:00:00Z",
"updatedAt": "2026-10-11T12:00:00Z"
}
Campaigns
Update, start or pause a campaign
Change a campaign’s settings, or start or pause it.
PATCH
/
campaigns
/
{id}
curl -X PATCH "https://api.nedzo.ai/v1/campaigns/123e4567-e89b-12d3-a456-426614174000" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "status": "live" }'
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"workspaceId": "789e4567-e89b-12d3-a456-426614174000",
"name": "September promo",
"voiceAgentId": "aaa11111-bbbb-2222-cccc-333344445555",
"savedViewId": "bbb11111-bbbb-2222-cccc-333344445555",
"dailyCapTalkMinutes": 120,
"maxFollowUps": 2,
"callingDays": [1, 2, 3, 4, 5],
"callingHoursStart": "09:00:00",
"callingHoursEnd": "17:00:00",
"callingTimezone": null,
"status": "live",
"createdAt": "2026-10-11T12:00:00Z",
"updatedAt": "2026-10-11T12:00:00Z"
}
This endpoint is for the VIP plan only. Other plans get a
403. See Plan access.workspaceId. A field we do not know gets a 400, so a typo never saves the rest of the change without it. A locked workspace cannot change a campaign.
string
required
Campaign UUID
string
live starts calling, paused stops it, completed ends it, draft takes it back to a draft. Setting live adds the contacts in the view right away. The dialer sets capped and out_of_funds, so you cannot send those.Errors
| Status | When |
|---|---|
400 | A field is missing, not valid, or one we do not know. |
402 | The account has no plan, or its subscription is not active. |
403 | Your plan is not VIP, or the workspace is locked. |
404 | The campaign does not exist, or your API key cannot reach it. |
500 | The change saved, but a follow-up step failed. The message says what to send again. |
curl -X PATCH "https://api.nedzo.ai/v1/campaigns/123e4567-e89b-12d3-a456-426614174000" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "status": "live" }'
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"workspaceId": "789e4567-e89b-12d3-a456-426614174000",
"name": "September promo",
"voiceAgentId": "aaa11111-bbbb-2222-cccc-333344445555",
"savedViewId": "bbb11111-bbbb-2222-cccc-333344445555",
"dailyCapTalkMinutes": 120,
"maxFollowUps": 2,
"callingDays": [1, 2, 3, 4, 5],
"callingHoursStart": "09:00:00",
"callingHoursEnd": "17:00:00",
"callingTimezone": null,
"status": "live",
"createdAt": "2026-10-11T12:00:00Z",
"updatedAt": "2026-10-11T12:00:00Z"
}
Was this page helpful?