Calendar Integration

FillCue provides an iCal feed URL that syncs your event dates to your calendar app. To set it up:

1. Go to Settings → Calendar.
2. Copy the Calendar Feed URL.
3. Add it to your calendar app using the instructions below.

Google Calendar:

1. Open Google Calendar in a web browser (not the mobile app).
2. Click the + next to "Other calendars" in the left sidebar.
3. Select From URL.
4. Paste your FillCue feed URL and click Add calendar.

Apple Calendar (macOS / iPhone / iPad):

1. Open Calendar and go to File → New Calendar Subscription (macOS) or Settings → Calendar → Accounts → Add Account → Other → Add Subscribed Calendar (iOS).
2. Paste your FillCue feed URL.
3. Set the refresh interval (every hour is recommended) and click Subscribe.

Outlook:

1. Open Outlook Calendar and click Add calendar.
2. Select Subscribe from web.
3. Paste your FillCue feed URL and give it a name (e.g., "FillCue Events").
4. Click Import.

Your calendar will update automatically as you create and fill outreach. Most calendar apps refresh subscribed feeds every 15–60 minutes.

The feed includes all your outreach events from the past 90 days and all future dates. Each gig date appears as a separate calendar event showing:

• The event title (your outreach title)
• Date and time
• Venue / location (if provided)
• Event description and notes

Events update automatically when you modify outreach details like title, venue, or dates. The server caches the feed for 5 minutes, so changes may take a few minutes to appear.

Each contact can also have their own calendar feed showing only the events they’ve accepted. This is useful for contacts who want to see their upcoming commitments at a glance.

How contacts get their calendar:

• When a contact accepts an outreach offer, the confirmation page includes an Add to Calendar button that downloads a one-time .ics file.
• Contacts with a calendar feed URL can subscribe to it in their calendar app to see all their accepted events, updated automatically.

You can find a contact’s calendar feed in their Contact History drawer (click the clock icon next to their name).

You can import events from other calendar apps by uploading an .ics file. This bulk-creates events in FillCue from your existing calendar data.

Supported sources: Google Calendar, Apple Calendar, Outlook, and any app that exports standard .ics files.

How to export from your calendar:

• Google Calendar: Settings → Import & Export → Export (downloads a .zip containing .ics files).
• Apple Calendar: File → Export → Export… and choose a calendar to export.
• Outlook: File → Open & Export → Import/Export → Export to a file → iCalendar.

What gets imported:

• Event title → outreach title
• Date and time → event dates
• Location → venue
• Description → event notes

Limitations:

• Recurring events are not supported and will be skipped. To import recurring events, export each occurrence individually from your calendar app first.
• All-day events are imported as full-day events (midnight to midnight).
• Duplicate events (same calendar UID) are automatically skipped.

FillCue’s calendar feeds are standard iCalendar (RFC 5545) URLs that can be consumed by any calendar application or integration.

Organization feed:

GET /api/cal/org?token={your-token}

Returns all gig dates for the organization (past 90 days + future). The token is generated in Settings → Calendar.

Contact feed:

GET /api/cal/contact?token={contact-token}

Returns accepted gig dates for a specific contact. The token is unique per contact.

Details:

• Format: text/calendar (iCalendar .ics)
• Auth: token-based (no API key needed — the URL is the authentication)
• Cache: 5-minute server-side cache
• Rate limited per organization / contact
• Regenerating a token in Settings immediately invalidates the old URL

If you shared your calendar link by mistake or want to revoke access, go to Settings → Calendar and click Regenerate. This creates a new URL and invalidates the old one — anyone using the old link will stop receiving updates within a few minutes.

You’ll need to re-add the new URL to your calendar app after regenerating.