Scheduled Meetings

POST /meetings

Summary Schedule a Meeting Notetaker for a future meeting by providing a join URL, time (UTC), and a display name for the notetaker.
URL /api/v1/meetings
Request Headers
  • Authorization – Rev [ClientApiKey]:[UserAPIKey]
  • Content-Type – application/json or application/xml
Request Body

Provide the meeting join URL, the meeting start time (UTC) broken into components, and the display name for the notetaker participant.

FieldTypeRequiredDescription
join_urlstring (absolute HTTP/HTTPS URL)YesPublic join link for the meeting.
yearintYesUTC year of the scheduled meeting.
monthintYesUTC month (1–12).
dayintYesUTC day of month (1-31).
hourintYesUTC hour (0–23).
minuteintYesUTC minute (0–59).
notetaker_display_namestringYesDisplay name used for the notetaker in the meeting.
Response

On success, 200 OK with an object containing the scheduled meeting identifier. Use this identifier with Get Scheduled Meeting Notetaker to retrieve full details.
Error Responses
  • 400 Bad Request – if the body is missing or invalid. Examples:
    • Request body is required.
    • Invalid notetaker_display_name. Must not be empty.
    • Invalid join_url. Must be an absolute HTTP/HTTPS URL.
    • Invalid date/time components.

Notes:

  • Times must be specified in UTC via the discrete components shown above.
  • Provide an HTTP/HTTPS join_url that the notetaker can join.
  • The response includes a meeting identifier you can use to retrieve details.

Sample Request (JSON)

{
  "join_url": "https://zoom.us/j/123456789?pwd=abc123",
  "year": 2025,
  "month": 1,
  "day": 15,
  "hour": 16,
  "minute": 30,
  "notetaker_display_name": "Rev Notetaker"
}

Sample Success Response (JSON)

{
  "id": "507f1f77bcf86cd799439011"
}