Meetings

Creating quick meeting

POST https://app.zencal.io/api/v1/meetings/quick

Use this method to generate a link to an online meeting. The generated link will also create a meeting in your Google or Outlook calendar (depending on the selected provider). The created meeting will have its duration set to the value specified in the duration parameter. The start time of the meeting is the time the request is called.

Headers

Request Body

{
    "url": "https://meet.google.com/abc-def-ghi"
}

POST https://app.zencal.io/api/v1/meetings/one-time

Use this method to generate a one-time link to schedule an appointment on a specific topic. Once an appointment has been made, this link will no longer be active.

Headers

Request Body

{
    "link": "https://app.zencal.io/meet/{LINK_UUID}"
}

Get meeting details

GET https://app.zencal.io/api/v1/meetings/{meetingUuid}

Use this method to get all information about particular meeting

Headers

{
    "uuid": "uuid",
    "start": "2024-01-01 00:00:00", // ISO8601, UTC
    "end": "2024-01-01 01:00:00", // ISO8601, UTC
    "status": "confirmed", // [created, confirmed, rejected, canceled, postponed]
    "place": "google-meet", // [offline, google-meet, teamsForBusiness, skypeForBusiness, skypeForConsumer, zoom, phone-call, webex]
    "joinMeetingLink": "http://meet.google.com/join/123",
    "topic": {
        "uuid": "uuid",
        "name": "Consulting 60 min",
        "metadata": {
            "field": "value"
        }
    },
    "attendee": {
        "name": "John Smith",
        "email": "email@john.com",
        "phone": "+1200300400"
    },
    "host": {
        "name": "Michale Bond",
        "email": "m@bond.com",
        "phone": "+12301010102"
    },
    "payment": {
        "amount": 10000, // value in pennies
        "currency": "USD",
        "status": "completed" // [registered, completed, failed]
    }
}

Last updated