Create Meeting (Beta) — DevRev

Creates a new meeting record.

Request

This endpoint expects an object.

channelenumRequired

The channel of meeting.

custom_schema_specobjectRequired

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.

memberslist of stringsRequired

IDs of the users that were part of the meeting.

scheduled_datestringRequiredformat: "date-time"

The date and time when the meeting was scheduled.

stateenumRequired

The state of meeting.

titlestringRequiredformat: "text"

The title of the meeting.

custom_fieldsobjectOptional

Application-defined custom fields.

descriptionstringOptionalformat: "text"

The description of the meeting.

ended_datestringOptionalformat: "date-time"

Time at which meeting ended.

external_refstringOptionalformat: "text"

External reference for the meeting.

external_urlstringOptionalformat: "text"

External URL for the meeting.

organizerstringOptionalformat: "id"

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

recordingstringOptionalformat: "id"

The ID of the meeting’s recording artifact.

recording_urlstringOptionalformat: "text"

The recording URL of the meeting.

tagslist of objectsOptional

Tags associated with the meeting.

transcriptstringOptionalformat: "id"

The ID of the artifact for the transcript of the meeting.

parentstringOptionalformat: "id"Deprecated

The parent object ID in which the meeting was created.

Response

Success.

meetingobject

1 curl -X POST https://api.devrev.ai/meetings.create \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "channel": "amazon_connect", 6 "custom_schema_spec": {}, 7 "members": [ 8 "members", 9 "members" 10 ], 11 "scheduled_date": "scheduled_date", 12 "state": "canceled", 13 "title": "title" 14 }'

1 { 2 "meeting": { 3 "channel": "amazon_connect", 4 "created_by": { 5 "type": "dev_user", 6 "display_picture": { 7 "file": { 8 "type": "type", 9 "name": "name" 10 }, 11 "id": "id", 12 "display_id": "display_id" 13 }, 14 "id": "id", 15 "state": "active", 16 "display_id": "display_id", 17 "display_name": "display_name", 18 "email": "email", 19 "full_name": "full_name" 20 }, 21 "id": "id", 22 "members": [ 23 { 24 "type": "dev_user", 25 "display_picture": { 26 "file": { 27 "type": "type", 28 "name": "name" 29 }, 30 "id": "id", 31 "display_id": "display_id" 32 }, 33 "id": "id", 34 "state": "active", 35 "display_id": "display_id", 36 "display_name": "display_name", 37 "email": "email", 38 "full_name": "full_name" 39 }, 40 { 41 "type": "dev_user", 42 "display_picture": { 43 "file": { 44 "type": "type", 45 "name": "name" 46 }, 47 "id": "id", 48 "display_id": "display_id" 49 }, 50 "id": "id", 51 "state": "active", 52 "display_id": "display_id", 53 "display_name": "display_name", 54 "email": "email", 55 "full_name": "full_name" 56 } 57 ], 58 "modified_by": { 59 "type": "dev_user", 60 "display_picture": { 61 "file": { 62 "type": "type", 63 "name": "name" 64 }, 65 "id": "id", 66 "display_id": "display_id" 67 }, 68 "id": "id", 69 "state": "active", 70 "display_id": "display_id", 71 "display_name": "display_name", 72 "email": "email", 73 "full_name": "full_name" 74 }, 75 "organizer": { 76 "type": "dev_user", 77 "display_picture": { 78 "file": { 79 "type": "type", 80 "name": "name" 81 }, 82 "id": "id", 83 "display_id": "display_id" 84 }, 85 "id": "id", 86 "state": "active", 87 "display_id": "display_id", 88 "display_name": "display_name", 89 "email": "email", 90 "full_name": "full_name" 91 }, 92 "parent": { 93 "type": "account", 94 "id": "id", 95 "display_id": "display_id", 96 "display_name": "display_name" 97 }, 98 "recording": { 99 "file": { 100 "type": "type", 101 "name": "name" 102 }, 103 "id": "id", 104 "display_id": "display_id" 105 }, 106 "state": "canceled", 107 "transcript": { 108 "file": { 109 "type": "type", 110 "name": "name" 111 }, 112 "id": "id", 113 "display_id": "display_id" 114 }, 115 "artifacts": [ 116 { 117 "file": { 118 "type": "type", 119 "name": "name" 120 }, 121 "id": "id", 122 "display_id": "display_id" 123 }, 124 { 125 "file": { 126 "type": "type", 127 "name": "name" 128 }, 129 "id": "id", 130 "display_id": "display_id" 131 } 132 ], 133 "created_date": "created_date", 134 "custom_fields": {}, 135 "custom_schema_fragments": [ 136 "custom_schema_fragments", 137 "custom_schema_fragments" 138 ], 139 "description": "description", 140 "display_id": "display_id", 141 "ended_date": "ended_date", 142 "external_ref": "external_ref", 143 "external_url": "external_url", 144 "modified_date": "modified_date", 145 "recording_url": "recording_url", 146 "scheduled_date": "scheduled_date", 147 "stock_schema_fragment": "stock_schema_fragment", 148 "subtype": "subtype", 149 "tags": [ 150 { 151 "tag": { 152 "id": "id", 153 "name": "name", 154 "style_new": { 155 "color": "color" 156 }, 157 "display_id": "display_id" 158 }, 159 "value": "value" 160 }, 161 { 162 "tag": { 163 "id": "id", 164 "name": "name", 165 "style_new": { 166 "color": "color" 167 }, 168 "display_id": "display_id" 169 }, 170 "value": "value" 171 } 172 ], 173 "title": "title" 174 } 175 }

1	curl -X POST https://api.devrev.ai/meetings.create \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"channel": "amazon_connect",
6	"custom_schema_spec": {},
7	"members": [
8	"members",
9	"members"
10	],
11	"scheduled_date": "scheduled_date",
12	"state": "canceled",
13	"title": "title"
14	}'

1	{
2	"meeting": {
3	"channel": "amazon_connect",
4	"created_by": {
5	"type": "dev_user",
6	"display_picture": {
7	"file": {
8	"type": "type",
9	"name": "name"
10	},
11	"id": "id",
12	"display_id": "display_id"
13	},
14	"id": "id",
15	"state": "active",
16	"display_id": "display_id",
17	"display_name": "display_name",
18	"email": "email",
19	"full_name": "full_name"
20	},
21	"id": "id",
22	"members": [
23	{
24	"type": "dev_user",
25	"display_picture": {
26	"file": {
27	"type": "type",
28	"name": "name"
29	},
30	"id": "id",
31	"display_id": "display_id"
32	},
33	"id": "id",
34	"state": "active",
35	"display_id": "display_id",
36	"display_name": "display_name",
37	"email": "email",
38	"full_name": "full_name"
39	},
40	{
41	"type": "dev_user",
42	"display_picture": {
43	"file": {
44	"type": "type",
45	"name": "name"
46	},
47	"id": "id",
48	"display_id": "display_id"
49	},
50	"id": "id",
51	"state": "active",
52	"display_id": "display_id",
53	"display_name": "display_name",
54	"email": "email",
55	"full_name": "full_name"
56	}
57	],
58	"modified_by": {
59	"type": "dev_user",
60	"display_picture": {
61	"file": {
62	"type": "type",
63	"name": "name"
64	},
65	"id": "id",
66	"display_id": "display_id"
67	},
68	"id": "id",
69	"state": "active",
70	"display_id": "display_id",
71	"display_name": "display_name",
72	"email": "email",
73	"full_name": "full_name"
74	},
75	"organizer": {
76	"type": "dev_user",
77	"display_picture": {
78	"file": {
79	"type": "type",
80	"name": "name"
81	},
82	"id": "id",
83	"display_id": "display_id"
84	},
85	"id": "id",
86	"state": "active",
87	"display_id": "display_id",
88	"display_name": "display_name",
89	"email": "email",
90	"full_name": "full_name"
91	},
92	"parent": {
93	"type": "account",
94	"id": "id",
95	"display_id": "display_id",
96	"display_name": "display_name"
97	},
98	"recording": {
99	"file": {
100	"type": "type",
101	"name": "name"
102	},
103	"id": "id",
104	"display_id": "display_id"
105	},
106	"state": "canceled",
107	"transcript": {
108	"file": {
109	"type": "type",
110	"name": "name"
111	},
112	"id": "id",
113	"display_id": "display_id"
114	},
115	"artifacts": [
116	{
117	"file": {
118	"type": "type",
119	"name": "name"
120	},
121	"id": "id",
122	"display_id": "display_id"
123	},
124	{
125	"file": {
126	"type": "type",
127	"name": "name"
128	},
129	"id": "id",
130	"display_id": "display_id"
131	}
132	],
133	"created_date": "created_date",
134	"custom_fields": {},
135	"custom_schema_fragments": [
136	"custom_schema_fragments",
137	"custom_schema_fragments"
138	],
139	"description": "description",
140	"display_id": "display_id",
141	"ended_date": "ended_date",
142	"external_ref": "external_ref",
143	"external_url": "external_url",
144	"modified_date": "modified_date",
145	"recording_url": "recording_url",
146	"scheduled_date": "scheduled_date",
147	"stock_schema_fragment": "stock_schema_fragment",
148	"subtype": "subtype",
149	"tags": [
150	{
151	"tag": {
152	"id": "id",
153	"name": "name",
154	"style_new": {
155	"color": "color"
156	},
157	"display_id": "display_id"
158	},
159	"value": "value"
160	},
161	{
162	"tag": {
163	"id": "id",
164	"name": "name",
165	"style_new": {
166	"color": "color"
167	},
168	"display_id": "display_id"
169	},
170	"value": "value"
171	}
172	],
173	"title": "title"
174	}
175	}