Add User to Calendar

Add a user to a shared Google Calendar.

Caution

To use this action card successfully, the Google Calendarconnection for this card must use the credentials of the calendar's owner.

Options

Field Definition Type Required
Calendar A dropdown list of your available calendars from which to remove a user. Dropdown TRUE
Send Notification? Indicates whether a notification is sent to the user once they're added to a shared Google Calendar. Boolean TRUE

Input

Field Definition Type Required
User
Email Email address of the user. String TRUE
Role Role of the user; options are:
  • none: Provides no access.

  • freeBusyReader: Provides read access to free/busy information.

  • reader: Provides read access to the calendar. Private events will appear to users with reader access, but event details will be hidden.

  • writer: Provides read and write access to the calendar. Private events will appear to users with writer access, and event details will be visible.

  • owner: Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to see and manipulate access control lists (ACLs).

Dropdown TRUE
Caution

A calendar, once assigned, will not automatically appear in a user's calendar list. To add a newly assigned calendar to a list, the user can click the Add this calendar link in the email notification that they receive after the calendar is assigned.

Output

Field Definition Type
Status Code Result of the operation. The HTTP status code is returned by the connector and indicates whether the action taken by the card succeeded or failed. For example:
  • A 201 Created status code indicates success where a new resource was created.
  • A 403 Forbidden error indicates that the HTTP request was not processed because the necessary permissions were missing.

For a full list of possible status codes, see HTTP status codes.

Number
Access Rule
ID Identifier of the Access Control List (ACL) rule. String
Scope The extent to which calendar access is granted by an ACL rule. Object
Type Type of data returned.

default: The public scope. This is the default value.

user: Limits the scope to a single user.

group: Limits the scope to a group.

domain: Limits the scope to a domain.

Note

The permissions granted to the default, or public, scope apply to any user, authenticated or not.

String
Value The email address of a user or group, or the name of a domain, depending on the scope type. Omitted for type default. String

Related topics

Google Calendar connector

About the elements of Okta Workflows

Google Calendar API documentation