Campaigns
Update campaign
Updates mutable campaign fields. Mailboxes can be replaced wholesale with mailbox_ids, or incrementally edited with add_mailbox_ids and remove_mailbox_ids. Tags can be replaced with tag_ids, or incrementally edited with add_tag_ids and remove_tag_ids.
/v1/campaigns/{id}Authorization
bearerAuth Use an account API key in the Authorization header: Authorization: Bearer f_....
In: header
Path Parameters
Campaign id.
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Send window. null means send 24/7.
IANA timezone, e.g. America/Chicago.
Inclusive start hour in the campaign timezone.
0 <= value <= 23Exclusive end hour in the campaign timezone.
0 <= value <= 23Allowed weekdays. Null/empty = every day.
Optional start minute. Defaults to 0 when omitted.
0 <= value <= 59Optional end minute. Defaults to 0 when omitted.
0 <= value <= 59Replace the campaign calendar bounds. Omitted leaves the current dates unchanged. null clears start_on and pause_on. start_at/pause_at are ignored on write.
IANA timezone used to interpret start_on and pause_on.
First local sending date. Null means start as soon as the campaign is launched.
dateExclusive local pause date. Null means the campaign never auto-pauses.
dateRead-only UTC instant of local midnight on start_on. Ignored on write.
date-timeRead-only UTC instant of local midnight on pause_on. Ignored on write.
date-timeReplace all tag assignments on the campaign.
curl -X PATCH "https://example.com/v1/campaigns/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{ "name": "Q2 Pipeline Refresh", "sending_interval_seconds": 1800, "add_mailbox_ids": [ "c23da7b6-df4e-4d2f-b100-4bb07b7d38d7" ] }'{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65", "bucket_id": "8f7ac8aa-ed2b-4e16-81e0-0766bdb092b8", "name": "string", "status": "draft", "source": "manual", "flow_data": { "nodes": [ { "id": "leadSource-1", "type": "leadSource", "position": { "x": 0, "y": 0 }, "data": { "label": "Lead Bucket", "customFieldKeys": [ "company" ], "mappedStandardFieldKeys": [ "email", "first_name", "last_name" ], "isRequired": true }, "deletable": false }, { "id": "email-1", "type": "email", "position": { "x": 220, "y": 0 }, "data": { "label": "Intro Email", "priority": false, "variants": [ { "id": "11111111-1111-4111-8111-111111111111", "label": "A", "subject": "Quick question for {{first_name}}", "template": "Hi {{first_name}} - reaching out about {{custom.company}}.", "isActive": true, "order": 0 }, { "id": "11111111-1111-4111-8111-111111111112", "label": "B", "subject": "Following up for {{first_name}}", "template": "Hi {{first_name}} - wanted to share a quick idea for {{custom.company}}.", "isActive": true, "order": 1 } ] } }, { "id": "waitTime-1", "type": "waitTime", "position": { "x": 460, "y": 0 }, "data": { "label": "Wait 1 day", "duration": "1", "unit": "days", "wait_duration_seconds": 86400 } }, { "id": "email-2", "type": "email", "position": { "x": 700, "y": 0 }, "data": { "label": "Follow-up", "priority": false, "variants": [ { "id": "22222222-2222-4222-8222-222222222221", "label": "A", "subject": "Bumping this for {{first_name}}", "template": "Hi {{first_name}} - circling back in case this is relevant for {{custom.company}}.", "isActive": true, "order": 0 }, { "id": "22222222-2222-4222-8222-222222222222", "label": "B", "subject": "Any thoughts, {{first_name}}?", "template": "Hi {{first_name}} - should I close the loop or send more detail?", "isActive": true, "order": 1 } ] } } ], "edges": [ { "id": "e1", "source": "leadSource-1", "target": "email-1" }, { "id": "e2", "source": "email-1", "target": "waitTime-1" }, { "id": "e3", "source": "waitTime-1", "target": "email-2" } ] }, "schedule": { "timezone": "America/Chicago", "start_hour": 9, "end_hour": 17, "days_of_week": [ 1, 2, 3, 4, 5 ], "start_minute": 0, "end_minute": 0 }, "sending_interval_seconds": 0, "lifecycle_schedule": { "time_zone": "America/Chicago", "start_on": "2026-09-01", "pause_on": "2026-10-01", "start_at": "2026-09-01T05:00:00.000Z", "pause_at": "2026-10-01T05:00:00.000Z" }, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "deleted_at": "2019-08-24T14:15:22Z", "tags": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "color": "string", "created_at": "2019-08-24T14:15:22Z" } ], "mailbox_ids": [ "66b30d1e-447a-440c-8f92-4f8a34e9bbee" ] }}{ "error": { "type": "invalid_request_error", "code": "invalid_flow", "message": "Flow validation failed" }, "details": [ { "path": "nodes[1].data.variants[0].id", "code": "invalid_variant_id", "message": "Email variants must have a stable UUID id." } ]}{ "error": { "type": "authentication_error", "code": "invalid_api_key", "message": "A valid Furnace API key is required" }}{ "error": { "type": "permission_error", "code": "smartlead_read_only", "message": "Smartlead campaigns are read-only via the API" }}{ "error": { "type": "invalid_request_error", "code": "campaign_not_found", "message": "Campaign not found" }}{ "error": { "type": "rate_limit_error", "code": "rate_limit_exceeded", "message": "Rate limit exceeded for this account" }}{ "error": { "type": "api_error", "code": "internal_error", "message": "Internal server error" }}