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

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