A calendar feed is a private, read-only web address for your timetable. Calendar apps such as Google Calendar, Apple Calendar and Outlook subscribe to it. In the app, the feature is called Calendar (iCal) Feed, and each feed is called a token.
To create or stop a feed, see How to sync your timetable to your calendar.
Availability
| Plan | Calendar feeds |
|---|---|
| Community | You cannot create a new feed. Account › Calendars shows “Calendar feeds aren’t available on your current plan.” A feed created on Professional keeps working. |
| Professional | Available |
See Subscription plans and fees.
Where to find it
Account › Calendars › Calendar (iCal) Feed.
Feed details
Each feed in the list shows:
| Detail | Description |
|---|---|
| Name | The Token Name (optional) you entered. Without a name, the feed is called “Default”. |
| Created | The date you created the feed. |
| Last accessed | The date a calendar app last read the feed. Shown after the first read. |
| Feed URL | The web address to paste into your calendar app. Select Copy feed URL to copy it. |
Web address
The address has this shape:
https://<Soniq Studio address>/v1/ical/<your profile ID>/<token>/calendar.ics
- The token is a long random code. It is the only thing that protects the feed, so anyone with the full address can read it.
- Each feed has its own token. You can have more than one feed, for example one for each device.
- The file format is iCalendar (
.ics), the standard format for calendar subscriptions.
What the feed contains
| Included | Not included |
|---|---|
| Lessons | Student Unavailable entries |
| Entries with the event type Event | Lessons you have cancelled |
| Weekly repeats, with the dates you cancelled or moved left out | Notes, prices, invoices and payment details |
| Moved lessons, at their new time | Contact details |
| Lessons from 90 days ago to 365 days ahead |
Each entry in the calendar app shows:
| Calendar field | Value |
|---|---|
| Title | The student’s name, or the Title of an Event |
| Start and end | The lesson time in UK time (Europe/London) |
| Repeat | The lesson’s Repeat every and Stop repeating (optional) settings |
| Status | Confirmed |
The calendar itself is named “Soniq Studio” followed by your profile ID. You can rename it in your calendar app.
Updates
| Behaviour | Detail |
|---|---|
| Direction | One way, from Soniq Studio to your calendar app. Changes in your calendar app do not reach Soniq Studio. |
| Soniq Studio refresh | The feed shows your current timetable. A copy can be up to 15 minutes old. |
| Calendar app refresh | Each calendar app decides how often it reads the feed. Some apps wait several hours between reads. |
Revoking a feed
| Action | Result |
|---|---|
| Select Revoke token, then Revoke Token | The address stops working at once. Calendar apps using it stop receiving updates. The feed leaves the list. |
| Create a new feed | A new address with a new token. Old addresses do not start working again. |