Meetings

Create Meeting

Creates a new meeting record.

POST
/meetings.create
AuthorizationBearer <token>

All the DevRev APIs require a token to authenticate the user. Provide Authorization: Bearer <TOKEN> as a header to every API request. How do I find my token?

In: header

channelmeeting-channel

The channel of meeting.

Value in"amazon_connect" | "google_meet" | "offline" | "other" | "teams" | "zoom"
custom_fields?object

Application-defined custom fields.

Empty Object

custom_schema_spec?custom-schema-spec

Custom schemas described using identifiers. Each custom field in the request must have the corresponding schema specified; omission results in a Bad Request error. If a custom schema is not included in the specifier, it remains unchanged. For surfaces with human interactors, it is recommended to provide tenant_fragment: true and validate_required_fields: true.

description?string

The description of the meeting.

Formattext
ended_date?string

Time at which meeting ended.

Formatdate-time
external_ref?string

External reference for the meeting.

Formattext
external_url?string

External URL for the meeting.

Formattext
membersarray<string>

IDs of the users that were part of the meeting.

Items1 <= items <= 800
organizer?string

The ID of the user who organized the meeting. If not provided, the creator is set as the organizer.

Formatid
parent?stringDeprecated

The parent object ID in which the meeting was created.

Formatid
recording_url?string

The recording URL of the meeting.

Formattext
scheduled_date?string

The date and time when the meeting was scheduled.

Formatdate-time
statemeeting-state

The state of meeting.

Value in"canceled" | "completed" | "no_show" | "ongoing" | "rejected" | "rescheduled" | "scheduled" | "waiting"
tags?array<set-tag-with-value>

Tags associated with the meeting.

titlestring

The title of the meeting.

Formattext

Response Body

curl -X POST "https://api.devrev.ai/meetings.create" \  -H "Content-Type: application/json" \  -d '{    "channel": "amazon_connect",    "members": [      "DEVU-12345"    ],    "state": "canceled",    "title": "string"  }'
{
  "meeting": {
    "created_by": {
      "type": "dev_user",
      "display_id": "string",
      "id": "string",
      "display_name": "string",
      "display_picture": {
        "display_id": "string",
        "id": "string",
        "file": {
          "type": "string",
          "name": "string",
          "size": 0
        }
      },
      "email": "string",
      "full_name": "string",
      "state": "active"
    },
    "created_date": "2023-01-01T12:00:00.000Z",
    "display_id": "string",
    "id": "string",
    "modified_by": {
      "type": "dev_user",
      "display_id": "string",
      "id": "string",
      "display_name": "string",
      "display_picture": {
        "display_id": "string",
        "id": "string",
        "file": {
          "type": "string",
          "name": "string",
          "size": 0
        }
      },
      "email": "string",
      "full_name": "string",
      "state": "active"
    },
    "modified_date": "2023-01-01T12:00:00.000Z"
  }
}
{
  "detail": "string",
  "message": "string",
  "type": "artifact_already_attached_to_a_parent",
  "existing_parent": "string",
  "is_same": true
}
{
  "detail": "string",
  "message": "string",
  "type": "unauthenticated"
}
{
  "detail": "string",
  "message": "string",
  "type": "forbidden"
}
{
  "detail": "string",
  "message": "string",
  "type": "too_many_requests",
  "retry_after": 0
}
{
  "detail": "string",
  "message": "string",
  "type": "internal_error",
  "reference_id": "string"
}
{
  "detail": "string",
  "message": "string",
  "type": "service_unavailable"
}