Calendars: insert

Creates a secondary calendar.

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

Try it now.

Request

HTTP request

POST https://www.googleapis.com/calendar/v3/calendars

Authorization

This request requires authorization with at least one of the following scopes:

Scope
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.calendars

For more information, see the authentication and authorization page.

Request body

In the request body, supply a Calendars resource with the following properties:

Property name Value Description Notes
Required Properties
summary string Title of the calendar. writable

Response

If successful, this method returns a Calendars resource in the response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-10-28 UTC.