Create Meeting (Beta) — DevRev

Creates a new meeting record.

Request

This endpoint expects an object.

channelenumRequired

The channel of meeting.

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.

custom_schema_specobjectOptional

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.

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 "members": [ 7 "members", 8 "members" 9 ], 10 "scheduled_date": "scheduled_date", 11 "state": "canceled", 12 "title": "title" 13 }'

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

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	"members": [
7	"members",
8	"members"
9	],
10	"scheduled_date": "scheduled_date",
11	"state": "canceled",
12	"title": "title"
13	}'

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