Holiday Settings
Manage posting on holidays
Control whether posts should be sent or blocked on holidays. Perfect for respecting cultural events and maximizing engagement.
Get Holiday Settings
GET /v1/workspaces/{id}/schedule/holidays/Response
{
"settings": {
"christmas": "blocked",
"thanksgiving-us": "blocked",
"new-year": "blocked",
"black-friday": "send",
"cyber-monday": "send",
"valentines-day": "send",
"easter": "blocked",
"independence-day-us": "blocked",
"labor-day-us": "send",
"memorial-day-us": "blocked"
}
}Update Multiple Holidays
Bulk update holiday settings:
PUT /v1/workspaces/{id}/schedule/holidays/Request Body
{
"settings": {
"christmas": "blocked",
"thanksgiving-us": "blocked",
"black-friday": "send",
"cyber-monday": "send"
}
}Example
curl -X PUT "https://api.missinglettr.com/v1/workspaces/1/schedule/holidays/" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"settings": {
"christmas": "blocked",
"new-year": "blocked",
"black-friday": "send"
}
}'Update Single Holiday
Update one holiday at a time:
PATCH /v1/workspaces/{id}/schedule/holidays/{holiday_id}/Example: Block Christmas
curl -X PATCH "https://api.missinglettr.com/v1/workspaces/1/schedule/holidays/christmas/" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"status": "blocked"}'Holiday Options
- send: Posts can be scheduled on this holiday (default)
- blocked: No posts will be scheduled on this holiday
Available Holidays
Supported holiday IDs (region-specific):
- US: christmas, thanksgiving-us, new-year, independence-day-us, memorial-day-us, labor-day-us
- Shopping: black-friday, cyber-monday
- International: valentines-day, easter, mothers-day, fathers-day
Best Practice: Block major holidays like Christmas and Thanksgiving when engagement is typically low. Allow shopping holidays like Black Friday when engagement is high.