Calendar & Events API (Retail — Patch 12.0.0)

Comprehensive reference for the in-game calendar and event scheduler.

Source: https://warcraft.wiki.gg/wiki/World_of_Warcraft_API Current as of: Patch 12.0.0 (Build 65655) — January 28, 2026 Scope: Retail only.

Scope

• C_Calendar — Full calendar system (50+ functions)
• C_EventScheduler — Scheduled event management

C_Calendar — Calendar System

Opening & Navigation

Month Info Fields

• month — Month number (1-12)
• year — Year
• numDays — Days in month
• firstWeekday — First day weekday (1=Sun)

Day Events

Event Info Fields

• title — Event title
• isCustomTitle — Player-created?
• startTime — Start date/time
• endTime — End date/time
• calendarType — Type (PLAYER, GUILD_EVENT, SYSTEM, HOLIDAY, RAID_LOCKOUT, etc.)
• sequenceType — Sequence (START, ONGOING, END)
• eventType — Event type enum
• texture — Event texture
• modStatus — Moderator status
• inviteStatus — Invite status enum
• invitedBy — Who invited
• difficulty — Difficulty ID
• inviteType — Invite type
• sequenceIndex — Sequence index
• numSequenceDays — Total sequence days
• difficultyName — Difficulty name
• isLocked — Locked?

Creating & Editing Events

Event Properties (Get/Set)

Invites

Invite Status Enums

Holidays

Filtered Events

Raid Resets

Event Type Textures

C_EventScheduler — Scheduled Events

Common Patterns

List Today's Events

C_Calendar.OpenCalendar()

local monthInfo = C_Calendar.GetMonthInfo(0)
local today = tonumber(date("%d"))

local numEvents = C_Calendar.GetNumDayEvents(today, 0)
for i = 1, numEvents do
    local event = C_Calendar.GetDayEvent(today, i, 0)
    if event then
        print(event.title, "-", event.calendarType)
    end
end

Create a Guild Event

C_Calendar.CreateGuildSignUpEvent()
C_Calendar.EventSetTitle("Raid Night - Mythic")
C_Calendar.EventSetDescription("Bring flasks and food.")
C_Calendar.EventSetDate(3, 15, 2026) -- March 15, 2026
C_Calendar.EventSetTime(20, 0) -- 8:00 PM
C_Calendar.EventSetType(1) -- Raid type
C_Calendar.AddEvent()

Check Upcoming Holidays

C_Calendar.OpenCalendar()
local monthInfo = C_Calendar.GetMonthInfo(0)

for day = 1, monthInfo.numDays do
    local numEvents = C_Calendar.GetNumDayEvents(day, 0)
    for i = 1, numEvents do
        local event = C_Calendar.GetDayEvent(day, i, 0)
        if event and event.calendarType == "HOLIDAY" then
            print("Holiday:", event.title, "- Day", day)
        end
    end
end

Key Events

Gotchas & Restrictions

1. OpenCalendar() required — Must call C_Calendar.OpenCalendar() before using other calendar functions.
2. Offset-based navigation — Day and month parameters are offsets from current, not absolute (for most functions).
3. Invite permissions — Only event owners/moderators can manage invites.
4. Calendar types — calendarType distinguishes PLAYER events from HOLIDAY, SYSTEM, RAID_LOCKOUT, etc.
5. Mass invite limits — Guild/community mass invites have level and rank filters.
6. Event creation requires hardware — AddEvent() typically requires user interaction.
7. Holiday info is read-only — Holidays are system-generated and cannot be modified.
8. Calendar data is async — Wait for CALENDAR_UPDATE_EVENT_LIST after opening the calendar.