Skip to content

Google: Creates an event — response body — attendees item

Creates an event.: response body, field attendees / item. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Creates an event — response body — attendees item

FieldTypePresenceDescription and constraints
$objectRoot
additionalGuestsJSONOptional
additionalGuests (anyOf 1)integerAlternativeNumber of additional guests. Optional. The default is 0.
Default: 0
Format: int32
additionalGuests (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
asyncOperationstringOptionalIf present, indicates the status of an asynchronous operation ongoing for this attendee (e.g. listing of members of large attendee groups). Read-only. The default is to not be present.
Possible values are:
- “inProgress” - The asynchronous operation is in progress.
- (not present) - Otherwise.
Default:
commentstringOptionalThe attendee’s response comment. Optional.
displayNamestringOptionalThe attendee’s name, if available. Optional.
emailstringOptionalThe attendee’s email address, if available. This field must be present when adding an attendee. It must be a valid email address as per RFC5322.
Required when adding an attendee.
idstringOptionalThe attendee’s Profile ID, if available.
optionalbooleanOptionalWhether this is an optional attendee. Optional. The default is False.
Default: false
organizerbooleanOptionalWhether the attendee is the organizer of the event. Read-only. The default is False.
resourcebooleanOptionalWhether the attendee is a resource. Can only be set when the attendee is added to the event for the first time. Subsequent modifications are ignored. Optional. The default is False.
Default: false
responseStatusstringOptionalThe attendee’s response status. Possible values are:
- “needsAction” - The attendee has not responded to the invitation (recommended for new events).
- “declined” - The attendee has declined the invitation.
- “tentative” - The attendee has tentatively accepted the invitation.
- “accepted” - The attendee has accepted the invitation. Warning: If you add an event using the values declined, tentative, or accepted, attendees with the “Add invitations to my calendar” setting set to “When I respond to invitation in email” or “Only if the sender is known” might have their response reset to needsAction and won’t see an event in their calendar unless they change their response in the event invitation email. Furthermore, if more than 200 guests are invited to the event, response status is not propagated to the guests.
selfbooleanOptionalWhether this entry represents the calendar on which this copy of the event appears. Read-only. The default is False.
Default: false

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.