Cronofy Docs

  • ISO 27001 Accredited

  • SOC 2 Attested

  • GDPR Compliant

  • HIPAA Compliant

Dashboard
  1. Home
  2. Developers
  3. API Reference
  4. Events
  5. Edit External Events

Edit External Events

Required plan: Starter

Description #

Allows the editing of external events, ie those not created through the Cronofy API connection.

See Create or Update Event for details of all possible parameters.

In order to make this call, you must request elevated access to access the user’s calendars. Then, the event itself must be have its options.update flag set to true.

This endpoint is the same as for managed events, however rather than specifying an event_id you will instead use the event_uid of the externally created event:

URL format #

api.cronofy.com/v1/calendars/{calendar_id}/events

Example Request #

POST /v1/calendars/cal_n23kjnwrw2_jsdfjksn234/events HTTP/1.1
Host: api.cronofy.com
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json; charset=utf-8

{
  "event_uid": "evt_external_54008b1a4a41730f8d5c6037",
  "summary": "Board meeting",
  "description": "Discuss plans for the next quarter.",
  "start": "2014-08-05T15:30:00Z",
  "end": "2014-08-05T17:00:00Z",
  "location": {
    "description": "Board room"
  }
}

When editing an externally created event the behavior is a little different to a partner event. Namely it is no longer an “upsert” so once the event is deleted you cannot recreate it. If you want to recreate an event we suggest that you instead create a fully managed event in its place.

Caveats #

Recurring events

Recurring events are not editable. In order to know if an event can be deleted or updated the options attribute can be inspected when making a Read Events request.

Recurring events can also be identified by the recurring Boolean attribute on events when making a Read Events request.

Search