Go to App

Calendar Events

Operations related to calendar events

Get calendar events

get

Retrieve a paginated list of calendar events with optional filtering

Autorizaciones
Parámetros de consulta
startDatestringOpcional

Filter calendar events by start date

Example: 2025-01-01
endDatestringOpcional

Filter calendar events by end date

Example: 2025-01-01
calendarIdstringOpcional

Filter calendar events by calendar ID

Example: 5516cd47-2bd0-4f4f-adc2-22524e54ba4d
statusstringOpcional

Filter calendar events by status

Example: confirmed
pagenumberOpcional

Page number

Example: 1
limitnumberOpcional

Number of items per page

Example: 10
Respuestas
200

Calendar events retrieved successfully

application/json
get
GET /api/v1/calendar-events HTTP/1.1
Host: api.salescaling.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "statusCode": 200,
  "count": 1,
  "error": "text",
  "data": [
    {
      "id": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d",
      "calendarId": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d",
      "title": "Team Meeting",
      "description": "Weekly team standup meeting",
      "startDateTime": "2024-07-15T10:00:00.000Z",
      "endDateTime": "2024-07-15T11:00:00.000Z",
      "location": "Conference Room A",
      "status": "confirmed",
      "visibility": "default",
      "organizerEmail": "[email protected]",
      "organizerName": "John Doe",
      "busy": true,
      "readOnly": false,
      "hideParticipants": false,
      "htmlLink": "https://calendar.google.com/event?eid=...",
      "iCalUID": "[email protected]",
      "nylasId": "nylas_event_123",
      "masterEventId": "master_event_123",
      "duration": 3600,
      "recurrence": [
        "FREQ=WEEKLY;BYDAY=MO"
      ],
      "participants": [
        {
          "email": "[email protected]",
          "name": "John Doe",
          "status": "yes"
        }
      ],
      "conferencing": {
        "provider": "Zoom Meeting",
        "details": {
          "url": "https://zoom.us/j/91288944390?pwd=1234567890"
        }
      },
      "metadata": {
        "customField": "value"
      },
      "createdAt": "2024-07-15T09:00:00.000Z",
      "updatedAt": "2024-07-15T09:30:00.000Z"
    }
  ]
}

Create calendar event

post

Create a new calendar event

Autorizaciones
Cuerpo
calendarIdstringRequerido

Calendar ID this event belongs to

Example: 5516cd47-2bd0-4f4f-adc2-22524e54ba4d
titlestringRequerido

Title of the calendar event

Example: Team Meeting
descriptionstringOpcional

Description of the calendar event

Example: Weekly team standup meeting
startDateTimestring · date-timeRequerido

Date and time when the event starts

Example: 2024-07-15T10:00:00.000Z
endDateTimestring · date-timeRequerido

Date and time when the event ends

Example: 2024-07-15T11:00:00.000Z
locationstringOpcional

Location of the event

Example: Conference Room A
statusstring · enumOpcional

Status of the calendar event

Example: confirmedValores posibles:
visibilitystring · enumOpcional

Visibility of the calendar event

Example: defaultValores posibles:
organizerEmailstringOpcional

Email of the event organizer

Example: [email protected]
organizerNamestringOpcional

Name of the event organizer

Example: John Doe
busybooleanOpcional

Whether the event is marked as busy

Example: true
readOnlybooleanOpcional

Whether the event is read-only

Example: false
hideParticipantsbooleanOpcional

Whether to hide participants

Example: false
durationnumberOpcional

Duration of the event in seconds

Example: 3600
recurrencestring[]Opcional

Recurrence rules for the event

Example: ["FREQ=WEEKLY;BYDAY=MO"]
meetingUrlstringOpcional

Meeting URL

Example: https://zoom.us/j/91288944390?pwd=1234567890
metadataobjectOpcional

Additional metadata for the event

Example: {"customField":"value"}
Respuestas
201

Calendar event created successfully

application/json
post
POST /api/v1/calendar-events HTTP/1.1
Host: api.salescaling.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 633

{
  "calendarId": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d",
  "title": "Team Meeting",
  "description": "Weekly team standup meeting",
  "startDateTime": "2024-07-15T10:00:00.000Z",
  "endDateTime": "2024-07-15T11:00:00.000Z",
  "location": "Conference Room A",
  "status": "confirmed",
  "visibility": "default",
  "organizerEmail": "[email protected]",
  "organizerName": "John Doe",
  "busy": true,
  "readOnly": false,
  "hideParticipants": false,
  "duration": 3600,
  "recurrence": [
    "FREQ=WEEKLY;BYDAY=MO"
  ],
  "participants": [
    {
      "email": "[email protected]",
      "name": "John Doe",
      "status": "yes"
    }
  ],
  "meetingUrl": "https://zoom.us/j/91288944390?pwd=1234567890",
  "metadata": {
    "customField": "value"
  }
}
{
  "statusCode": 200,
  "count": 1,
  "error": "text",
  "data": {
    "id": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d",
    "calendarId": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d",
    "title": "Team Meeting",
    "description": "Weekly team standup meeting",
    "startDateTime": "2024-07-15T10:00:00.000Z",
    "endDateTime": "2024-07-15T11:00:00.000Z",
    "location": "Conference Room A",
    "status": "confirmed",
    "visibility": "default",
    "organizerEmail": "[email protected]",
    "organizerName": "John Doe",
    "busy": true,
    "readOnly": false,
    "hideParticipants": false,
    "htmlLink": "https://calendar.google.com/event?eid=...",
    "iCalUID": "[email protected]",
    "nylasId": "nylas_event_123",
    "masterEventId": "master_event_123",
    "duration": 3600,
    "recurrence": [
      "FREQ=WEEKLY;BYDAY=MO"
    ],
    "participants": [
      {
        "email": "[email protected]",
        "name": "John Doe",
        "status": "yes"
      }
    ],
    "conferencing": {
      "provider": "Zoom Meeting",
      "details": {
        "url": "https://zoom.us/j/91288944390?pwd=1234567890"
      }
    },
    "metadata": {
      "customField": "value"
    },
    "createdAt": "2024-07-15T09:00:00.000Z",
    "updatedAt": "2024-07-15T09:30:00.000Z"
  }
}

Get calendar event by ID

get

Retrieve a specific calendar event by its ID

Autorizaciones
Parámetros de ruta
idstringRequerido

Calendar event ID

Example: 5516cd47-2bd0-4f4f-adc2-22524e54ba4d
Respuestas
200

Calendar event retrieved successfully

application/json
get
GET /api/v1/calendar-events/{id} HTTP/1.1
Host: api.salescaling.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "statusCode": 200,
  "count": 1,
  "error": "text",
  "data": {
    "id": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d",
    "calendarId": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d",
    "title": "Team Meeting",
    "description": "Weekly team standup meeting",
    "startDateTime": "2024-07-15T10:00:00.000Z",
    "endDateTime": "2024-07-15T11:00:00.000Z",
    "location": "Conference Room A",
    "status": "confirmed",
    "visibility": "default",
    "organizerEmail": "[email protected]",
    "organizerName": "John Doe",
    "busy": true,
    "readOnly": false,
    "hideParticipants": false,
    "htmlLink": "https://calendar.google.com/event?eid=...",
    "iCalUID": "[email protected]",
    "nylasId": "nylas_event_123",
    "masterEventId": "master_event_123",
    "duration": 3600,
    "recurrence": [
      "FREQ=WEEKLY;BYDAY=MO"
    ],
    "participants": [
      {
        "email": "[email protected]",
        "name": "John Doe",
        "status": "yes"
      }
    ],
    "conferencing": {
      "provider": "Zoom Meeting",
      "details": {
        "url": "https://zoom.us/j/91288944390?pwd=1234567890"
      }
    },
    "metadata": {
      "customField": "value"
    },
    "createdAt": "2024-07-15T09:00:00.000Z",
    "updatedAt": "2024-07-15T09:30:00.000Z"
  }
}

Update calendar event

put

Update an existing calendar event

Autorizaciones
Parámetros de ruta
idstringRequerido

Calendar event ID

Example: 5516cd47-2bd0-4f4f-adc2-22524e54ba4d
Cuerpo
titlestringOpcional

Title of the calendar event

Example: Team Meeting
descriptionstringOpcional

Description of the calendar event

Example: Weekly team standup meeting
startDateTimestring · date-timeOpcional

Date and time when the event starts

Example: 2024-07-15T10:00:00.000Z
endDateTimestring · date-timeOpcional

Date and time when the event ends

Example: 2024-07-15T11:00:00.000Z
locationstringOpcional

Location of the event

Example: Conference Room A
statusstring · enumOpcional

Status of the calendar event

Example: confirmedValores posibles:
visibilitystring · enumOpcional

Visibility of the calendar event

Example: defaultValores posibles:
organizerEmailstringOpcional

Email of the event organizer

Example: [email protected]
organizerNamestringOpcional

Name of the event organizer

Example: John Doe
busybooleanOpcional

Whether the event is marked as busy

Example: true
readOnlybooleanOpcional

Whether the event is read-only

Example: false
hideParticipantsbooleanOpcional

Whether to hide participants

Example: false
durationnumberOpcional

Duration of the event in seconds

Example: 3600
recurrencestring[]Opcional

Recurrence rules for the event

Example: ["FREQ=WEEKLY;BYDAY=MO"]
meetingUrlstringOpcional

Meeting URL

Example: https://zoom.us/j/91288944390?pwd=1234567890
metadataobjectOpcional

Additional metadata for the event

Example: {"customField":"value"}
Respuestas
200

Calendar event updated successfully

application/json
put
PUT /api/v1/calendar-events/{id} HTTP/1.1
Host: api.salescaling.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 581

{
  "title": "Team Meeting",
  "description": "Weekly team standup meeting",
  "startDateTime": "2024-07-15T10:00:00.000Z",
  "endDateTime": "2024-07-15T11:00:00.000Z",
  "location": "Conference Room A",
  "status": "confirmed",
  "visibility": "default",
  "organizerEmail": "[email protected]",
  "organizerName": "John Doe",
  "busy": true,
  "readOnly": false,
  "hideParticipants": false,
  "duration": 3600,
  "recurrence": [
    "FREQ=WEEKLY;BYDAY=MO"
  ],
  "participants": [
    {
      "email": "[email protected]",
      "name": "John Doe",
      "status": "yes"
    }
  ],
  "meetingUrl": "https://zoom.us/j/91288944390?pwd=1234567890",
  "metadata": {
    "customField": "value"
  }
}
{
  "statusCode": 200,
  "count": 1,
  "error": "text",
  "data": {
    "id": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d",
    "calendarId": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d",
    "title": "Team Meeting",
    "description": "Weekly team standup meeting",
    "startDateTime": "2024-07-15T10:00:00.000Z",
    "endDateTime": "2024-07-15T11:00:00.000Z",
    "location": "Conference Room A",
    "status": "confirmed",
    "visibility": "default",
    "organizerEmail": "[email protected]",
    "organizerName": "John Doe",
    "busy": true,
    "readOnly": false,
    "hideParticipants": false,
    "htmlLink": "https://calendar.google.com/event?eid=...",
    "iCalUID": "[email protected]",
    "nylasId": "nylas_event_123",
    "masterEventId": "master_event_123",
    "duration": 3600,
    "recurrence": [
      "FREQ=WEEKLY;BYDAY=MO"
    ],
    "participants": [
      {
        "email": "[email protected]",
        "name": "John Doe",
        "status": "yes"
      }
    ],
    "conferencing": {
      "provider": "Zoom Meeting",
      "details": {
        "url": "https://zoom.us/j/91288944390?pwd=1234567890"
      }
    },
    "metadata": {
      "customField": "value"
    },
    "createdAt": "2024-07-15T09:00:00.000Z",
    "updatedAt": "2024-07-15T09:30:00.000Z"
  }
}

Delete calendar event

delete

Delete a calendar event by its ID

Autorizaciones
Parámetros de ruta
idstringRequerido

Calendar event ID

Example: 5516cd47-2bd0-4f4f-adc2-22524e54ba4d
Respuestas
200

Calendar event deleted successfully

application/json
delete
DELETE /api/v1/calendar-events/{id} HTTP/1.1
Host: api.salescaling.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "statusCode": 200,
  "count": 1,
  "error": "text",
  "data": true
}
AnteriorCalendarsSiguienteCalls