Send feedback
Calendars: insert
Stay organized with collections
Save and categorize content based on your preferences.
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.
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/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://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
summarystringTitle of the calendar.
writable
Try it!
Use the APIs Explorer below to call this method on live data and see the response.
Send feedback
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.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-10-28 UTC."],[],[]]
