Feeds ALPHA

Required plan: Emerging

Feeds provide the ability to bring externally hosted ICS feeds into Cronofy so that they can be access alongside user’s calendars.

When connected they act as a read-only calendar account. That means you can use them in conjuction with our scheduling tools, and take advantage of our push notification channels to be informed when a feed changes.

URL format #

{data_center_url}/v1/feeds

Example Request #

POST /v1/feeds HTTP/1.1
Host: {data_center_url}
Authorization: Bearer {API_KEY}
Content-Type: application/json; charset=utf-8

{
  "feed_url": {FEED_URL}
}

Example Response #

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "token_type": "bearer",
  "access_token": {RANDOM_TOKEN},
  "expires_in": 3600,
  "refresh_token": {RANDOM_TOKEN},
  "scope": "read_only",
  "sub": "apf_64b181d18090ea21640c915b",
  "linking_profile": {
    "profile_id": "pro_n23kjnwrw2",
  }
}

Request parameters #

data_center_url required

The URL for the data center you want to communicate with. Possible choices are:

  • api-au.cronofy.com - πŸ‡¦πŸ‡Ί Australia
  • api-ca.cronofy.com - πŸ‡¨πŸ‡¦ Canada
  • api-de.cronofy.com - πŸ‡©πŸ‡ͺ Germany
  • api-sg.cronofy.com - πŸ‡ΈπŸ‡¬ Singapore
  • api-uk.cronofy.com - πŸ‡¬πŸ‡§ United Kingdom
  • api.cronofy.com - πŸ‡ΊπŸ‡Έ United States

Find out more about Cronofy's data centers.

API_KEY required  #

The client_secret of the client creating the event.

feed_url required  #

The URL of the ICS feed to import.

This must be an externally accessible URL which provides a text/calendar response containing valid iCalendar information.