Create Account — DevRev

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

Request

This endpoint expects an object.

display_namestringRequired

Name of the account.

descriptionstringOptional

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.

tierstringOptional

The tier of the account.

websiteslist of stringsOptional

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

Response

The response to creating a new account.

accountobject

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": "sys_user", 7 "id": "owned_by" 8 } 9 ], 10 "created_by": { 11 "type": "sys_user", 12 "id": "created_by", 13 "display_id": "created_by", 14 "display_name": "created_by", 15 "display_picture": { 16 "id": "id" 17 }, 18 "email": "created_by", 19 "full_name": "created_by", 20 "state": "active" 21 }, 22 "created_date": "2023-01-01T12:00:00Z", 23 "description": "description", 24 "display_id": "display_id", 25 "display_name": "display_name", 26 "domains": [ 27 "domains" 28 ], 29 "external_refs": [ 30 "external_refs" 31 ], 32 "modified_by": { 33 "type": "sys_user", 34 "id": "modified_by", 35 "display_id": "modified_by", 36 "display_name": "modified_by", 37 "display_picture": { 38 "id": "id" 39 }, 40 "email": "modified_by", 41 "full_name": "modified_by", 42 "state": "active" 43 }, 44 "modified_date": "2023-01-01T12:00:00Z", 45 "tier": "tier", 46 "websites": [ 47 "websites" 48 ] 49 } 50 }

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": "sys_user",
7	"id": "owned_by"
8	}
9	],
10	"created_by": {
11	"type": "sys_user",
12	"id": "created_by",
13	"display_id": "created_by",
14	"display_name": "created_by",
15	"display_picture": {
16	"id": "id"
17	},
18	"email": "created_by",
19	"full_name": "created_by",
20	"state": "active"
21	},
22	"created_date": "2023-01-01T12:00:00Z",
23	"description": "description",
24	"display_id": "display_id",
25	"display_name": "display_name",
26	"domains": [
27	"domains"
28	],
29	"external_refs": [
30	"external_refs"
31	],
32	"modified_by": {
33	"type": "sys_user",
34	"id": "modified_by",
35	"display_id": "modified_by",
36	"display_name": "modified_by",
37	"display_picture": {
38	"id": "id"
39	},
40	"email": "modified_by",
41	"full_name": "modified_by",
42	"state": "active"
43	},
44	"modified_date": "2023-01-01T12:00:00Z",
45	"tier": "tier",
46	"websites": [
47	"websites"
48	]
49	}
50	}