Update email campaign schedule (global settings)

Deprecated

PATCH
/emails/campaigns/{campaignId}/settings/global

Replaces the campaign schedule (sending window, pace, tracking). The campaign must not be RUNNING or ARCHIVED. Extra validation beyond the schema: minInterval <= maxInterval, start <= end, dailyLimit >= dailyContact. Changing days/start/end/tracking rewrites each step version's per-day schedule. New integrations should use the multichannel /advanced campaign endpoints instead.

Authorization

apiKey
Authorization<token>

Your 48 character API key, sent as is (a Bearer prefix is tolerated). Create it at https://v3.emelia.io/settings/api.

In: header

Path Parameters

campaignId*string

Mongo ObjectId of the campaign.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X PATCH "https://example.com/emails/campaigns/65f1a2b3c4d5e6f73478765e/settings/global" \  -H "Authorization: YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "schedule": {      "dailyContact": 50,      "dailyLimit": 200,      "minInterval": 60,      "maxInterval": 300,      "blacklistUnsub": true,      "trackLinks": true,      "trackOpens": true,      "timeZone": "Europe/Paris",      "days": [        0,        1,        2,        3,        4      ],      "start": "09:00",      "end": "18:00",      "eventToStopMails": [        "REPLIED"      ]    }  }'
{  "success": true,  "campaign": {    "_id": "6650f1a2b839d800244fe91d",    "userId": "6650f1a2b839d800da35bbc5",    "name": "Q4 outreach: SaaS founders",    "status": "DRAFT",    "provider": "6650f1a2b839d80045d6927b",    "useManyProviders": true,    "providersUsed": [      "6650f1a2b839d8002184f429"    ],    "schedule": {      "bcc": "",      "dailyContact": 35,      "dailyLimit": 100,      "minInterval": 60,      "maxInterval": 180,      "blacklistUnsub": true,      "trackLinks": true,      "trackOpens": true,      "timeZone": "Europe/Paris",      "days": [        1      ],      "start": "08:00",      "end": "17:00",      "eventToStopMails": []    },    "steps": [      {        "_id": "6650f1a2b839d8001e904670",        "delay": {          "amount": 1,          "unit": "DAYS"        },        "versions": [          {            "_id": "6650f1a2b839d8008207665f",            "subject": "Quick question about Nexora",            "message": "Hi Claire, thanks for your reply. Are you free for a call on Thursday?",            "disabled": false,            "rawHtml": true,            "attachments": [],            "options": {}          }        ]      }    ],    "recipients": {      "lists": [        {}      ],      "contacts": [        "6650f1a2b839d8008ddef4f3"      ],      "processing": true    },    "zapierData": [      {        "webhookUrl": "https://hooks.yourcompany.com/emelia",        "events": []      }    ],    "createdAt": "2026-10-06T09:30:00.000Z",    "startAt": "2026-10-06T09:30:00.000Z",    "estimatedEnd": "2026-10-06T09:30:00.000Z",    "plannedStart": "2026-10-06T09:30:00.000Z"  }}