Meetings

Creating quick meeting

Get a link to Google Meet / Microsoft Teams / Skype / Zoom / Cisco Webex

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

Name	Type	Description
X-Zencal-Api-Key*	String	Zencal Api key
Content-Type*	String	application/json
Accept*	String	application/json

Request Body

Name	Type	Description
duration*	Integer	Duration of the meeting
provider*	String	A calendar in which an online meeting will be created. Available values are: "google" or "outlook"

201: Created

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

Generate one-time link to scheduling page

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

Name	Type	Description
X-Zencal-Api-Key*	String	Zencal Api key
Accept*	String	application/json
Content-Type*	String	application/json

Request Body

Name	Type	Description
username*	String	Username of the user to whom the participant will be scheduled
meetingTopic*	String	Uuid of the meeting topic which the owner is the host or co-host (in team topics)

201: Created

{
    "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

Name	Type	Description
X-Zencal-Api-Key*	String	Zencal Api key
Accept*	String	application/json
Content-Type*	String	application/json

200

{
    "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": "[e-mail]",
        "phone": "[phone]"
    },
    "host": {
        "name": "Michale Bond",
        "email": "[e-mail]",
        "phone": "[phone]"
    },
    "payment": {
        "amount": 10000, // value in pennies
        "currency": "USD",
        "status": "completed" // [registered, completed, failed]
    }
}

404

{
    "error": "Meeting not found"
}