iCal Integration

iCalendar Integration

Artland supports the iCalendar standard (RFC 5545) for event subscriptions.

How It Works

You can provide a calendar feed URL in two places:

Event payload — per-event ical_url field
Profile update — entity-level ical_url field

Artland displays a “Subscribe to calendar” link on your profile page, allowing visitors to subscribe to your events.

Setting Up

Option 1: Profile-Level Calendar

Set a calendar feed URL on your profile:

curl -X PUT https://api.artland.com/v1/profile \
  -H "Authorization: Bearer *** \
  -H "Content-Type: application/json" \
  -d '{
    "ical_url": "https://your-gallery.com/calendar.ics"
  }'

Option 2: Per-Event Calendar

Include ical_url when creating events:

curl -X POST https://api.artland.com/v1/events \
  -H "Authorization: Bearer *** \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Spring Exhibition",
    "start_date": "2026-04-15",
    "end_date": "2026-05-30",
    "ical_url": "https://your-gallery.com/events/spring.ics"
  }'

Supported Clients

Client	How to Subscribe
Google Calendar	Click the subscribe link, or paste the URL in “Other calendars → Add by URL”
Apple Calendar	File → New Calendar Subscription, paste the URL
Microsoft Outlook	Open Calendar → Add calendar → From web, paste the URL

iCal URL Requirements

Must be a publicly accessible URL
Must serve text/calendar content type
Must be a valid .ics file (RFC 5545)
Must be a permanent URL (not temporary or signed)

Dashboard Management

You can also manage events and calendar URLs directly from the Artland dashboard at /account/events — no API required.