Create Account (Beta) — DevRev

Creates an account, which is a record representing a customer or an organization.

Request

This endpoint expects an object.

display_namestringRequiredformat: "text"

Name of the account.

artifactslist of stringsOptional

The IDs of the artifacts to associate with the account.

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"

Description of the account.

domainslist of stringsOptional

List of company’s domain names. Example - [‘devrev.ai’].

external_refslist of stringsOptional

External refs are unique identifiers from your customer system of records, stored as a list.

owned_bylist of stringsOptional

List of Dev users owning this account.

tagslist of objectsOptional

Tags associated with the account.

tierstringOptionalformat: "text"

The tier of the account.

websiteslist of stringsOptional

List of company websites. Example - [‘www.devrev.ai’, ‘www.marketplace.devrev.ai’].

schema_fragment_idslist of stringsOptionalDeprecated

Schema fragment IDs associated with this account SOR.

Response

The response to creating a new account.

accountobject

default_rev_orgobject

1 curl -X POST https://api.devrev.ai/accounts.create \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "display_name": "display_name" 6 }'

1 { 2 "account": { 3 "id": "id", 4 "owned_by": [ 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 "created_by": { 63 "type": "dev_user", 64 "id": "id", 65 "display_id": "display_id", 66 "display_name": "display_name", 67 "display_picture": { 68 "id": "id", 69 "file": {} 70 }, 71 "email": "email", 72 "full_name": "full_name", 73 "state": "active" 74 }, 75 "created_date": "created_date", 76 "custom_fields": {}, 77 "custom_schema_fragments": [ 78 "custom_schema_fragments", 79 "custom_schema_fragments" 80 ], 81 "description": "description", 82 "display_id": "display_id", 83 "display_name": "display_name", 84 "domains": [ 85 "domains", 86 "domains" 87 ], 88 "external_refs": [ 89 "external_refs", 90 "external_refs" 91 ], 92 "modified_by": { 93 "type": "dev_user", 94 "id": "id", 95 "display_id": "display_id", 96 "display_name": "display_name", 97 "display_picture": { 98 "id": "id", 99 "file": {} 100 }, 101 "email": "email", 102 "full_name": "full_name", 103 "state": "active" 104 }, 105 "modified_date": "modified_date", 106 "stock_schema_fragment": "stock_schema_fragment", 107 "subtype": "subtype", 108 "tags": [ 109 { 110 "tag": { 111 "id": "id", 112 "name": "name", 113 "display_id": "display_id", 114 "style_new": { 115 "color": "color" 116 } 117 }, 118 "value": "value" 119 }, 120 { 121 "tag": { 122 "id": "id", 123 "name": "name", 124 "display_id": "display_id", 125 "style_new": { 126 "color": "color" 127 } 128 }, 129 "value": "value" 130 } 131 ], 132 "tier": "tier", 133 "websites": [ 134 "websites", 135 "websites" 136 ] 137 }, 138 "default_rev_org": { 139 "id": "id", 140 "account": { 141 "id": "id", 142 "display_id": "display_id", 143 "display_name": "display_name" 144 }, 145 "artifacts": [ 146 { 147 "id": "id", 148 "display_id": "display_id", 149 "file": { 150 "type": "type", 151 "name": "name", 152 "size": 1 153 } 154 }, 155 { 156 "id": "id", 157 "display_id": "display_id", 158 "file": { 159 "type": "type", 160 "name": "name", 161 "size": 1 162 } 163 } 164 ], 165 "created_by": { 166 "type": "dev_user", 167 "id": "id", 168 "display_id": "display_id", 169 "display_name": "display_name", 170 "display_picture": { 171 "id": "id", 172 "file": {} 173 }, 174 "email": "email", 175 "full_name": "full_name", 176 "state": "active" 177 }, 178 "created_date": "created_date", 179 "custom_fields": {}, 180 "custom_schema_fragments": [ 181 "custom_schema_fragments", 182 "custom_schema_fragments" 183 ], 184 "description": "description", 185 "display_id": "display_id", 186 "display_name": "display_name", 187 "external_ref": "external_ref", 188 "modified_by": { 189 "type": "dev_user", 190 "id": "id", 191 "display_id": "display_id", 192 "display_name": "display_name", 193 "display_picture": { 194 "id": "id", 195 "file": {} 196 }, 197 "email": "email", 198 "full_name": "full_name", 199 "state": "active" 200 }, 201 "modified_date": "modified_date", 202 "stock_schema_fragment": "stock_schema_fragment", 203 "subtype": "subtype", 204 "tags": [ 205 { 206 "tag": { 207 "id": "id", 208 "name": "name", 209 "display_id": "display_id", 210 "style_new": { 211 "color": "color" 212 } 213 }, 214 "value": "value" 215 }, 216 { 217 "tag": { 218 "id": "id", 219 "name": "name", 220 "display_id": "display_id", 221 "style_new": { 222 "color": "color" 223 } 224 }, 225 "value": "value" 226 } 227 ], 228 "domain": "domain" 229 } 230 }

1	curl -X POST https://api.devrev.ai/accounts.create \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"display_name": "display_name"
6	}'

1	{
2	"account": {
3	"id": "id",
4	"owned_by": [
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	"created_by": {
63	"type": "dev_user",
64	"id": "id",
65	"display_id": "display_id",
66	"display_name": "display_name",
67	"display_picture": {
68	"id": "id",
69	"file": {}
70	},
71	"email": "email",
72	"full_name": "full_name",
73	"state": "active"
74	},
75	"created_date": "created_date",
76	"custom_fields": {},
77	"custom_schema_fragments": [
78	"custom_schema_fragments",
79	"custom_schema_fragments"
80	],
81	"description": "description",
82	"display_id": "display_id",
83	"display_name": "display_name",
84	"domains": [
85	"domains",
86	"domains"
87	],
88	"external_refs": [
89	"external_refs",
90	"external_refs"
91	],
92	"modified_by": {
93	"type": "dev_user",
94	"id": "id",
95	"display_id": "display_id",
96	"display_name": "display_name",
97	"display_picture": {
98	"id": "id",
99	"file": {}
100	},
101	"email": "email",
102	"full_name": "full_name",
103	"state": "active"
104	},
105	"modified_date": "modified_date",
106	"stock_schema_fragment": "stock_schema_fragment",
107	"subtype": "subtype",
108	"tags": [
109	{
110	"tag": {
111	"id": "id",
112	"name": "name",
113	"display_id": "display_id",
114	"style_new": {
115	"color": "color"
116	}
117	},
118	"value": "value"
119	},
120	{
121	"tag": {
122	"id": "id",
123	"name": "name",
124	"display_id": "display_id",
125	"style_new": {
126	"color": "color"
127	}
128	},
129	"value": "value"
130	}
131	],
132	"tier": "tier",
133	"websites": [
134	"websites",
135	"websites"
136	]
137	},
138	"default_rev_org": {
139	"id": "id",
140	"account": {
141	"id": "id",
142	"display_id": "display_id",
143	"display_name": "display_name"
144	},
145	"artifacts": [
146	{
147	"id": "id",
148	"display_id": "display_id",
149	"file": {
150	"type": "type",
151	"name": "name",
152	"size": 1
153	}
154	},
155	{
156	"id": "id",
157	"display_id": "display_id",
158	"file": {
159	"type": "type",
160	"name": "name",
161	"size": 1
162	}
163	}
164	],
165	"created_by": {
166	"type": "dev_user",
167	"id": "id",
168	"display_id": "display_id",
169	"display_name": "display_name",
170	"display_picture": {
171	"id": "id",
172	"file": {}
173	},
174	"email": "email",
175	"full_name": "full_name",
176	"state": "active"
177	},
178	"created_date": "created_date",
179	"custom_fields": {},
180	"custom_schema_fragments": [
181	"custom_schema_fragments",
182	"custom_schema_fragments"
183	],
184	"description": "description",
185	"display_id": "display_id",
186	"display_name": "display_name",
187	"external_ref": "external_ref",
188	"modified_by": {
189	"type": "dev_user",
190	"id": "id",
191	"display_id": "display_id",
192	"display_name": "display_name",
193	"display_picture": {
194	"id": "id",
195	"file": {}
196	},
197	"email": "email",
198	"full_name": "full_name",
199	"state": "active"
200	},
201	"modified_date": "modified_date",
202	"stock_schema_fragment": "stock_schema_fragment",
203	"subtype": "subtype",
204	"tags": [
205	{
206	"tag": {
207	"id": "id",
208	"name": "name",
209	"display_id": "display_id",
210	"style_new": {
211	"color": "color"
212	}
213	},
214	"value": "value"
215	},
216	{
217	"tag": {
218	"id": "id",
219	"name": "name",
220	"display_id": "display_id",
221	"style_new": {
222	"color": "color"
223	}
224	},
225	"value": "value"
226	}
227	],
228	"domain": "domain"
229	}
230	}