Sign in
Calendar

Create a calendar

Creates a calendar.

post/v3/grants/{grant_id}/calendars

Query parameters

selectstring

Specify fields that you want Nylas to return, as a comma-separated list (for example, select=id,updated_at). This allows you to receive only the portion of object data that you're interested in. You can use select to optimize response size and reduce latency by limiting queries to only the information that you need.

Request body

descriptionstring

(Not supported for iCloud or EWS) A brief description of the calendar.

locationstring

(Not supported for iCloud or EWS) The geographic location of the calendar, as free-form text.

metadataMetadata

The metadata associated with the object. For more information, see Metadata.

namestring required

The name of the calendar.

timezonestring

(Google and virtual calendars only) An IANA timezone database formatted string (for example, America/New_York).

Example request

{
  "description": "Junior sports league carpool drivers",
  "location": "London, England",
  "name": "My New Calendar",
  "notetaker": {
    "meeting_settings": {
      "action_items": true,
      "action_items_settings": {
        "custom_instructions": "Only return the 5 most important action items."
      },
      "audio_recording": true,
      "leave_after_silence_seconds": 360,
      "summary": true,
      "summary_settings": {
        "custom_instructions": "Return this summary in the MEDPIC sales methodology."
      },
      "transcription": true,
      "video_recording": true,
      "transcription_settings": {
        "expected_languages": [
          "en",
          "es"
        ],
        "fallback_language": "en",
        "keywords": [
          "Nylas",
          "AssemblyAI"
        ],
        "use_speaker_names_as_keywords": true
      }
    },
    "name": "Nylas Notetaker",
    "rules": {
      "event_selection": [
        "internal"
      ],
      "participant_filter": {
        "participants_gte": 5,
        "participants_lte": 5
      }
    }
  },
  "timezone": "America/Los_Angeles"
}

Response

Calendar Response

request_idstring

The request ID.

Example response

{
  "request_id": "5fa64c92-e840-4357-86b9-2aa364d35b88"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.