State Holidays

What a State Holiday Is

A state holiday entry marks one or more specific dates as no-call days for leads in specified states. When a holiday is active and the current date (in the call's time zone) matches any date in the holiday's list, all outbound calls to the affected states are blocked.

Key Fields

• name: the holiday name (e.g., "Christmas", "Thanksgiving").
• Holiday Dates: a list of dates in YYYY-MM-DD format. Multiple dates can be listed for holidays that span multiple days or recur across years.
• states: the states the holidays are for
• company_id: the owning company.

State Matching

Holidays do not have a "federal" or blank-state concept. Each holiday must explicitly list the states it applies to in the states array. To block calls to all states, include all 51 entries (50 states plus us-dc).

How Blocking Works

When evaluated, the holiday checks whether the call's state (formatted as us-{state_code}) is in the states array, then checks whether today's date (in the call's time zone) is in the holiday dates. If both match, the call is blocked with next_action_at set to 7 AM the following day.