Cronofy Docs

Dashboard
  1. Home
  2. Developers
  3. API Reference
  4. Events
  5. Participation Status

Participation Status

Description

Changes the status of a user’s participation in an event.

In order for this to be possible, you must request the change_participation_status scope when requesting authorization to access the user’s calendars.

URL format

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

Example Request

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

{
    "status": "accepted"
}

Example Response

HTTP/1.1 202 Accepted

Request parameters

calendar_id required  #

The calendar_id of the calendar that contains the event for which you’d like to update the participation status. This ID can be retrieved using a list calendars request

This calendar must not have a calendar_readonly value that is true.

event_uid required  #

The String that uniquely identifies the event. This ID can be retrieved using the read events request.

This event must be have its options.change_participation_status flag set to true.

status required  #

A String representing the participation status you’d like to set. Acceptable values are:

  • accepted - to accept the invite
  • tentative - to tentatively accept the invite
  • declined - to decline the invite
Search