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: a PostgreSQL text array of state codes using the us-XX format (e.g., us-ca, us-ny). Each entry uses a lowercase two-letter abbreviation prefixed with "us-".
• 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.