Calendar Overview

Solo's calendar system provides event management capabilities integrated with your identity and agents.

Core Concepts

Events

Events are the primary unit of the calendar system. Each event belongs to an identity and can include:

Title & Description: Event details
Time Range: Start and end times with timezone support
Location: Physical location or virtual meeting link
Recurrence: Daily, weekly, biweekly, monthly, or yearly repeats
Invitees: People invited to the event
Agent Association: Link to a specific agent for branded communications

Invitees

Invitees are external participants invited to your events. For each invitee, Solo tracks:

Email & Name: Contact information
Response Status: needs_action, accepted, declined, or tentative
Optional Flag: Whether attendance is required or optional

Calendar Invitations

When you create or update an event with sendEmailReminders: true, Solo automatically sends invitation emails:

Event Created/Updated
       ↓
Generate ICS File (iCalendar format)
       ↓
Apply Identity/Agent Branding
       ↓
Send Email with ICS Attachment
       ↓
Invitee Receives Clickable Calendar Invite

Integration with Email System

Calendar invitations leverage Solo's existing email infrastructure:

Feature	Behavior
From Address	Uses identity's `fromAliasFormat` setting
Email Template	Applies identity's selected email template
Brand Colors	Uses identity's brand colors in template
Agent Signature	If `agentId` specified, includes agent's signature

This means calendar invites automatically match your brand identity and maintain consistency with other emails.

ICS File Format

Solo generates standard iCalendar (.ics) files that work with:

Google Calendar
Apple Calendar (iCal)
Microsoft Outlook
Any calendar app supporting iCalendar

Key features of generated ICS files:

TZID Parameters: Ensures correct timezone display (not UTC 'Z' suffix)
ORGANIZER: Your identity name and email
ATTENDEES: All invitees with RSVP=TRUE
LOCATION/URL: Physical or virtual meeting location

Example ICS output:

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Solo//Calendar//EN
CALSCALE:GREGORIAN
METHOD:REQUEST
BEGIN:VEVENT
UID:event-uuid@solomail.io
DTSTAMP:20260116T120000Z
DTSTART;TZID=America/New_York:20260120T090000
DTEND;TZID=America/New_York:20260120T093000
SUMMARY:Team Standup
ORGANIZER;CN=John from Acme Inc:mailto:john@solomail.io
ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=NEEDS-ACTION;RSVP=TRUE;CN=Jane:mailto:jane@example.com
LOCATION:Conference Room A
STATUS:CONFIRMED
END:VEVENT
END:VCALENDAR

Agent Integration

Events can be associated with specific agents using the agentId field. When an agent is associated:

Branded Invitations: Invites use the agent's signature and from name format
Tracking: Events appear in agent activity and can be queried by agent
Workflow Integration: Agents can programmatically manage calendar events

This is useful for:

Scheduling assistant agents booking meetings
Support agents scheduling follow-up calls
Sales agents organizing demos

Availability Checking

Before creating events, you can check availability to avoid conflicts:

GET /calendar/availability?startTime=2026-01-20T09:00:00Z&endTime=2026-01-20T10:00:00Z

Response indicates if the time slot is free and lists any conflicting events.

Next: Learn about Creating Events