Meetings

Create Meeting

Creates a new meeting record.

POST
/meetings.create

Creates a new meeting record.

Authorization

auth-token

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

Request Body

application/json

channel*string

The channel of meeting.

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

Application-defined custom fields.

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
members*array<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
state*string

The state of meeting.

Value in"canceled" | "completed" | "no_show" | "ongoing" | "rejected" | "rescheduled" | "scheduled" | "waiting"
tags?

Tags associated with the meeting.

title*string

The title of the meeting.

Formattext

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

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