Google Calendar API

CalendarList: insert

Requires authorization

Adds an entry to the user's calendar list. Try it now or see an example.

Request

HTTP request

POST https://www.googleapis.com/calendar/v3/users/me/calendarList

Parameters

Parameter name Value Description
Optional query parameters
colorRgbFormat boolean Whether to use the foregroundColor and backgroundColor fields to write the calendar colors (RGB). If this feature is used, the index-based colorId field will be set to the best matching option automatically. Optional. The default is False.

Authorization

This request requires authorization with the following scope (read more about authentication and authorization).

Scope
https://www.googleapis.com/auth/calendar

Request body

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

Property name Value Description Notes
Required Properties
defaultReminders[].method string The method used by this reminder. Possible values are:
  • "email" - Reminders are sent via email.
  • "sms" - Reminders are sent via SMS.
  • "popup" - Reminders are sent via a UI popup.
defaultReminders[].minutes integer Number of minutes before the start of the event when the reminder should trigger.
id string Identifier of the calendar.
notificationSettings.notifications[].method string The method used to deliver the notification. Possible values are:
  • "email" - Reminders are sent via email.
  • "sms" - Reminders are sent via SMS. This value is read-only and is ignored on inserts and updates.
notificationSettings.notifications[].type string The type of notification. Possible values are:
  • "eventCreation" - Notification sent when a new event is put on the calendar.
  • "eventChange" - Notification sent when an event is changed.
  • "eventCancellation" - Notification sent when an event is cancelled.
  • "eventResponse" - Notification sent when an event is changed.
  • "agenda" - An agenda with the events of the day (sent out in the morning).
Optional Properties
backgroundColor string The main color of the calendar in the format '#0088aa'. This property supersedes the index-based colorId property. Optional. writable
colorId string The color of the calendar. This is an ID referring to an entry in the "calendar" section of the colors definition (see the "colors" endpoint). Optional. writable
defaultReminders[] list The default reminders that the authenticated user has for this calendar. writable
foregroundColor string The foreground color of the calendar in the format '#ffffff'. This property supersedes the index-based colorId property. Optional. writable
hidden boolean Whether the calendar has been hidden from the list. Optional. The default is False. writable
notificationSettings object The notifications that the authenticated user is receiving for this calendar. writable
selected boolean Whether the calendar content shows up in the calendar UI. Optional. The default is False. writable
summaryOverride string The summary that the authenticated user has set for this calendar. Optional. writable

Response

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

Examples

Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).

Java

Uses the Java client library.

CalendarListEntry calendarListEntry = new CalendarListEntry();
calendarListEntry.setId("calendarId");

CalendarListEntry createdCalendarListEntry = service.calendarList().insert(calendarListEntry).execute();

System.out.println(createdCalendarListEntry.getSummary());

Python

Uses the Python client library.

calendar_list_entry = {
    'id': 'calendarId'
}

created_calendar_list_entry = service.calendarList().insert(body=calendar_list_entry).execute()

print created_calendar_list_entry['summary']

PHP

Uses the PHP client library.

$calendarListEntry = new CalendarListEntry();
$calendarListEntry->setId("calendarId");

$createdCalendarListEntry = $service->calendarList->insert($calendarListEntry);

echo $createdCalendarListEntry->getSummary();

Ruby

Uses the Ruby client library.

entry = {
  'id' => 'calendarId'
}

result = client.execute(:api_method => service.calendar_list.insert,
                        :body => JSON.dump(entry),
                        :headers => {'Content-Type' => 'application/json'})
print result.data.summary

Try it!

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

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.