calendars

POST /calendars

Changed on Nov 3, 2026

Creates a secondary calendar. The authenticated user for the request is made the data owner of the new calendar.

Note: We recommend to authenticate as the intended data owner of the calendar. You can use domain-wide delegation of authority to allow applications to act on behalf of a specific user. Don't use a service account for authentication. If you use a service account for authentication, the service account is the data owner, which can lead to unexpected behavior. For example, if a service account is the data owner, data ownership cannot be transferred.

Request

Base URL
https://www.googleapis.com/calendar/v3
URL
https://www.googleapis.com/calendar/v3/calendars
Auth
- OAuth 2 and OAuth 2
  Implicit: https://accounts.google.com/o/oauth2/auth
  Scopes: https://www.googleapis.com/auth/calendar
  Authorization code: https://accounts.google.com/o/oauth2/auth
  Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/calendar
- or OAuth 2 and OAuth 2
  Implicit: https://accounts.google.com/o/oauth2/auth
  Scopes: https://www.googleapis.com/auth/calendar.app.created
  Authorization code: https://accounts.google.com/o/oauth2/auth
  Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/calendar.app.created
- or OAuth 2 and OAuth 2
  Implicit: https://accounts.google.com/o/oauth2/auth
  Scopes: https://www.googleapis.com/auth/calendar.calendars
  Authorization code: https://accounts.google.com/o/oauth2/auth
  Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/calendar.calendars

Request body

autoAcceptInvitationsboolean

Whether this calendar automatically accepts invitations. Only valid for resource calendars.

dataOwnerstring

The email of the owner of the calendar. Set only for secondary calendars. Read-only.

descriptionstring

Description of the calendar. Optional.

etagstring

ETag of the resource.

idstring

Identifier of the calendar. To retrieve IDs call the calendarList.list() method.

kindstring

Type of the resource ("calendar#calendar").

locationstring

Geographic location of the calendar as free-form text. Optional.

summarystring

Title of the calendar.

timeZonestring

The time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. "Europe/Zurich".) Optional.

Response

Successful response