Skip to main content
POST
Configures when and how frequently campaign emails are sent Sets timezone (IANA format), sending hours (start/end in 24-hour format), active days of week (0=Sunday through 6=Saturday), and minimum time between consecutive emails (in minutes)

Overview

Configures when and how frequently campaign emails are sent Key Features:
  • Validates timezone string and time format before saving

Path Parameters

number
required
The ID of the campaign to update

Query Parameters

string
required
Your SmartLead API key

Request Body

object
required
Sending schedule configuration

Response Codes

Success
Request successful
Bad Request
Invalid request parameters or malformed request body
Unauthorized
Invalid or missing API key. Check your authentication.
Not Found
The requested resource (campaign, lead, email account, etc.) does not exist or you don’t have access to it
Validation Error
Request validation failed. Check parameter types, required fields, and value constraints.
Rate Limit Exceeded
Too many requests. Please slow down and retry after the rate limit resets.
Internal Server Error
Server error occurred. Please try again or contact support if the issue persists.
Service Unavailable
API is temporarily unavailable or under maintenance. Please try again later.

Schedule Best Practices

Business Hours

Send during recipient’s business hours:
  • B2B: 9 AM - 5 PM local time
  • B2C: 10 AM - 8 PM local time
  • Global: Consider multiple timezones

Days of Week

Time Between Emails

  • 120+ minutes: Appears more natural
  • 60-120 minutes: Moderate pacing
  • 30-60 minutes: Aggressive (use carefully)
Longer delays between emails (2-3 hours) result in better deliverability and appear more natural to recipients.

Common Timezones

  • America/New_York - US Eastern
  • America/Los_Angeles - US Pacific
  • America/Chicago - US Central
  • Europe/London - UK
  • Europe/Paris - Central Europe
  • Asia/Tokyo - Japan
  • Asia/Dubai - UAE
  • Asia/Kolkata - India
  • Australia/Sydney - Australia
See full list of timezones

Implementation Details

Schedule timezone must be valid IANA timezone. Start/end hours in 24-hour format. Min time between emails prevents rapid-fire sending. Response Format: object