Skip to main content
GET
/
calendars
/
events
Get Calendar Events
curl --request GET \
  --url https://services.leadconnectorhq.com/calendars/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Version: <version>'
{
  "events": [
    {
      "id": "ocQHyuzHvysMo5N5VsXc",
      "title": "Appointment with HoopAI Platform Dev team",
      "calendarId": "BqTwX8QFwXzpegMve9EQ",
      "locationId": "0007BWpSzSwfiuSl0tR2",
      "contactId": "9NkT25Vor1v4aQatFsv2",
      "groupId": "9NkT25Vor1v4aQatFsv2",
      "appointmentStatus": "confirmed",
      "assignedUserId": "YlWd2wuCAZQzh2cH1fVZ",
      "users": [
        "YlWd2wuCAZQzh2cH1fVZ",
        "9NkT25Vor1v4aQatFsv2"
      ],
      "startTime": "2023-09-25T16:00:00+05:30",
      "endTime": "2023-09-25T16:00:00+05:30",
      "dateAdded": "2023-09-25T16:00:00+05:30",
      "dateUpdated": "2023-09-25T16:00:00+05:30",
      "address": "https://meet.google.com/yqp-gogr-wve",
      "notes": "Some dummy note",
      "description": "Some dummy description",
      "isRecurring": "true",
      "rrule": "RRULE:FREQ=DAILY;INTERVAL=1;COUNT=5",
      "assignedResources": [
        "<string>"
      ],
      "createdBy": {
        "source": "<string>",
        "userId": "<string>"
      },
      "masterEventId": "ocWd2wuBGAQzh2cH1fSZ"
    }
  ]
}

Authorizations

Authorization
string
header
required

Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.

Headers

Version
enum<string>
required

API Version

Available options:
2021-04-15

Query Parameters

locationId
string
required

Location Id

Example:

"0007BWpSzSwfiuSl0tR2"

userId
string

User Id - Owner of an appointment. Either of userId, groupId or calendarId is required

Example:

"CVokAlI8fgw4WYWoCtQz"

calendarId
string

Either of calendarId, userId or groupId is required

Example:

"BqTwX8QFwXzpegMve9EQ"

groupId
string

Either of groupId, calendarId or userId is required

Example:

"ocQHyuzHvysMo5N5VsXc"

startTime
string
required

Start Time (in millis)

Example:

"1680373800000"

endTime
string
required

End Time (in millis)

Example:

"1680978599999"

Response

Successful response

events
object[]
Last modified on March 4, 2026