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

Errors

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": "foo" 6 }'

1 { 2 "account": { 3 "id": "foo", 4 "owned_by": [ 5 { 6 "display_id": "foo", 7 "id": "foo", 8 "display_name": "foo", 9 "display_picture": { 10 "display_id": "foo", 11 "id": "foo", 12 "file": { 13 "type": "foo", 14 "name": "foo", 15 "size": 42 16 } 17 }, 18 "email": "foo", 19 "full_name": "foo", 20 "state": "active" 21 } 22 ], 23 "artifacts": [ 24 { 25 "id": "foo", 26 "display_id": "foo", 27 "file": { 28 "type": "foo", 29 "name": "foo", 30 "size": 42 31 } 32 } 33 ], 34 "created_by": { 35 "display_id": "foo", 36 "id": "foo", 37 "display_name": "foo", 38 "display_picture": { 39 "display_id": "foo", 40 "id": "foo", 41 "file": { 42 "type": "foo", 43 "name": "foo", 44 "size": 42 45 } 46 }, 47 "email": "foo", 48 "full_name": "foo", 49 "state": "active" 50 }, 51 "created_date": "2023-01-01T12:00:00.000Z", 52 "custom_fields": {}, 53 "custom_schema_fragments": [ 54 "foo" 55 ], 56 "description": "foo", 57 "display_id": "foo", 58 "display_name": "foo", 59 "domains": [ 60 "foo" 61 ], 62 "external_refs": [ 63 "foo" 64 ], 65 "modified_by": { 66 "display_id": "foo", 67 "id": "foo", 68 "display_name": "foo", 69 "display_picture": { 70 "display_id": "foo", 71 "id": "foo", 72 "file": { 73 "type": "foo", 74 "name": "foo", 75 "size": 42 76 } 77 }, 78 "email": "foo", 79 "full_name": "foo", 80 "state": "active" 81 }, 82 "modified_date": "2023-01-01T12:00:00.000Z", 83 "primary_account": { 84 "id": "foo", 85 "display_id": "foo", 86 "display_name": "foo" 87 }, 88 "stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id", 89 "subtype": "foo", 90 "tags": [ 91 { 92 "tag": { 93 "id": "foo", 94 "name": "foo", 95 "display_id": "foo", 96 "style_new": { 97 "color": "foo" 98 } 99 }, 100 "value": "foo" 101 } 102 ], 103 "tier": "foo", 104 "websites": [ 105 "foo" 106 ] 107 }, 108 "default_rev_org": { 109 "id": "foo", 110 "account": { 111 "id": "foo", 112 "display_id": "foo", 113 "display_name": "foo" 114 }, 115 "artifacts": [ 116 { 117 "id": "foo", 118 "display_id": "foo", 119 "file": { 120 "type": "foo", 121 "name": "foo", 122 "size": 42 123 } 124 } 125 ], 126 "created_by": { 127 "display_id": "foo", 128 "id": "foo", 129 "display_name": "foo", 130 "display_picture": { 131 "display_id": "foo", 132 "id": "foo", 133 "file": { 134 "type": "foo", 135 "name": "foo", 136 "size": 42 137 } 138 }, 139 "email": "foo", 140 "full_name": "foo", 141 "state": "active" 142 }, 143 "created_date": "2023-01-01T12:00:00.000Z", 144 "custom_fields": {}, 145 "custom_schema_fragments": [ 146 "foo" 147 ], 148 "description": "foo", 149 "display_id": "foo", 150 "display_name": "foo", 151 "external_ref": "foo", 152 "modified_by": { 153 "display_id": "foo", 154 "id": "foo", 155 "display_name": "foo", 156 "display_picture": { 157 "display_id": "foo", 158 "id": "foo", 159 "file": { 160 "type": "foo", 161 "name": "foo", 162 "size": 42 163 } 164 }, 165 "email": "foo", 166 "full_name": "foo", 167 "state": "active" 168 }, 169 "modified_date": "2023-01-01T12:00:00.000Z", 170 "primary_rev_org": { 171 "display_id": "foo", 172 "id": "foo", 173 "display_name": "foo" 174 }, 175 "stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id", 176 "subtype": "foo", 177 "tags": [ 178 { 179 "tag": { 180 "id": "foo", 181 "name": "foo", 182 "display_id": "foo", 183 "style_new": { 184 "color": "foo" 185 } 186 }, 187 "value": "foo" 188 } 189 ], 190 "domain": "foo" 191 } 192 }

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": "foo"
6	}'

1	{
2	"account": {
3	"id": "foo",
4	"owned_by": [
5	{
6	"display_id": "foo",
7	"id": "foo",
8	"display_name": "foo",
9	"display_picture": {
10	"display_id": "foo",
11	"id": "foo",
12	"file": {
13	"type": "foo",
14	"name": "foo",
15	"size": 42
16	}
17	},
18	"email": "foo",
19	"full_name": "foo",
20	"state": "active"
21	}
22	],
23	"artifacts": [
24	{
25	"id": "foo",
26	"display_id": "foo",
27	"file": {
28	"type": "foo",
29	"name": "foo",
30	"size": 42
31	}
32	}
33	],
34	"created_by": {
35	"display_id": "foo",
36	"id": "foo",
37	"display_name": "foo",
38	"display_picture": {
39	"display_id": "foo",
40	"id": "foo",
41	"file": {
42	"type": "foo",
43	"name": "foo",
44	"size": 42
45	}
46	},
47	"email": "foo",
48	"full_name": "foo",
49	"state": "active"
50	},
51	"created_date": "2023-01-01T12:00:00.000Z",
52	"custom_fields": {},
53	"custom_schema_fragments": [
54	"foo"
55	],
56	"description": "foo",
57	"display_id": "foo",
58	"display_name": "foo",
59	"domains": [
60	"foo"
61	],
62	"external_refs": [
63	"foo"
64	],
65	"modified_by": {
66	"display_id": "foo",
67	"id": "foo",
68	"display_name": "foo",
69	"display_picture": {
70	"display_id": "foo",
71	"id": "foo",
72	"file": {
73	"type": "foo",
74	"name": "foo",
75	"size": 42
76	}
77	},
78	"email": "foo",
79	"full_name": "foo",
80	"state": "active"
81	},
82	"modified_date": "2023-01-01T12:00:00.000Z",
83	"primary_account": {
84	"id": "foo",
85	"display_id": "foo",
86	"display_name": "foo"
87	},
88	"stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id",
89	"subtype": "foo",
90	"tags": [
91	{
92	"tag": {
93	"id": "foo",
94	"name": "foo",
95	"display_id": "foo",
96	"style_new": {
97	"color": "foo"
98	}
99	},
100	"value": "foo"
101	}
102	],
103	"tier": "foo",
104	"websites": [
105	"foo"
106	]
107	},
108	"default_rev_org": {
109	"id": "foo",
110	"account": {
111	"id": "foo",
112	"display_id": "foo",
113	"display_name": "foo"
114	},
115	"artifacts": [
116	{
117	"id": "foo",
118	"display_id": "foo",
119	"file": {
120	"type": "foo",
121	"name": "foo",
122	"size": 42
123	}
124	}
125	],
126	"created_by": {
127	"display_id": "foo",
128	"id": "foo",
129	"display_name": "foo",
130	"display_picture": {
131	"display_id": "foo",
132	"id": "foo",
133	"file": {
134	"type": "foo",
135	"name": "foo",
136	"size": 42
137	}
138	},
139	"email": "foo",
140	"full_name": "foo",
141	"state": "active"
142	},
143	"created_date": "2023-01-01T12:00:00.000Z",
144	"custom_fields": {},
145	"custom_schema_fragments": [
146	"foo"
147	],
148	"description": "foo",
149	"display_id": "foo",
150	"display_name": "foo",
151	"external_ref": "foo",
152	"modified_by": {
153	"display_id": "foo",
154	"id": "foo",
155	"display_name": "foo",
156	"display_picture": {
157	"display_id": "foo",
158	"id": "foo",
159	"file": {
160	"type": "foo",
161	"name": "foo",
162	"size": 42
163	}
164	},
165	"email": "foo",
166	"full_name": "foo",
167	"state": "active"
168	},
169	"modified_date": "2023-01-01T12:00:00.000Z",
170	"primary_rev_org": {
171	"display_id": "foo",
172	"id": "foo",
173	"display_name": "foo"
174	},
175	"stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id",
176	"subtype": "foo",
177	"tags": [
178	{
179	"tag": {
180	"id": "foo",
181	"name": "foo",
182	"display_id": "foo",
183	"style_new": {
184	"color": "foo"
185	}
186	},
187	"value": "foo"
188	}
189	],
190	"domain": "foo"
191	}
192	}