Create (Beta) — 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.

artifactslist of stringsOptional

The IDs of the artifacts to associate with the account.

custom_fieldsmap from strings to anyOptional

Application-defined custom fields.

custom_schema_specobjectOptional

Requested custom schemas described abstractly. Every provided schema’s custom field must be specified, otherwise a bad request error is returned. If a new custom schema specifier is provided, then it will be added to the work, otherwise if a custom schema is omitted from the specifier, it remains unmodified.

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.

tagslist of objectsOptional

Tags associated with the account.

tierstringOptional

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

This endpoint returns an object.

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 "external_refs": [ 4 "external_refs" 5 ], 6 "id": "id", 7 "owned_by": [ 8 { 9 "type": "sys_user", 10 "id": "owned_by" 11 } 12 ], 13 "artifacts": [ 14 { 15 "id": "id" 16 } 17 ], 18 "created_by": { 19 "type": "sys_user", 20 "id": "created_by", 21 "display_id": "created_by", 22 "display_name": "created_by", 23 "display_picture": { 24 "id": "id" 25 }, 26 "email": "created_by", 27 "full_name": "created_by", 28 "state": "active" 29 }, 30 "created_date": "2023-01-01T12:00:00Z", 31 "custom_fields": { 32 "key": "value" 33 }, 34 "custom_schema_fragments": [ 35 "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>" 36 ], 37 "description": "description", 38 "display_id": "display_id", 39 "display_name": "display_name", 40 "domains": [ 41 "domains" 42 ], 43 "modified_by": { 44 "type": "sys_user", 45 "id": "modified_by", 46 "display_id": "modified_by", 47 "display_name": "modified_by", 48 "display_picture": { 49 "id": "id" 50 }, 51 "email": "modified_by", 52 "full_name": "modified_by", 53 "state": "active" 54 }, 55 "modified_date": "2023-01-01T12:00:00Z", 56 "stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>", 57 "subtype": "subtype", 58 "tags": [ 59 { 60 "tag": { 61 "id": "id", 62 "name": "name" 63 } 64 } 65 ], 66 "tier": "tier" 67 }, 68 "default_rev_org": { 69 "id": "id", 70 "account": { 71 "id": "id", 72 "display_id": "display_id", 73 "display_name": "display_name" 74 }, 75 "artifacts": [ 76 { 77 "id": "id" 78 } 79 ], 80 "created_by": { 81 "type": "sys_user", 82 "id": "created_by", 83 "display_id": "created_by", 84 "display_name": "created_by", 85 "display_picture": { 86 "id": "id" 87 }, 88 "email": "created_by", 89 "full_name": "created_by", 90 "state": "active" 91 }, 92 "created_date": "2023-01-01T12:00:00Z", 93 "custom_fields": { 94 "key": "value" 95 }, 96 "custom_schema_fragments": [ 97 "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>" 98 ], 99 "description": "description", 100 "display_id": "display_id", 101 "display_name": "display_name", 102 "domain": "domain", 103 "external_ref": "external_ref", 104 "modified_by": { 105 "type": "sys_user", 106 "id": "modified_by", 107 "display_id": "modified_by", 108 "display_name": "modified_by", 109 "display_picture": { 110 "id": "id" 111 }, 112 "email": "modified_by", 113 "full_name": "modified_by", 114 "state": "active" 115 }, 116 "modified_date": "2023-01-01T12:00:00Z", 117 "stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>", 118 "subtype": "subtype", 119 "tags": [ 120 { 121 "tag": { 122 "id": "id", 123 "name": "name" 124 } 125 } 126 ] 127 } 128 }

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	"external_refs": [
4	"external_refs"
5	],
6	"id": "id",
7	"owned_by": [
8	{
9	"type": "sys_user",
10	"id": "owned_by"
11	}
12	],
13	"artifacts": [
14	{
15	"id": "id"
16	}
17	],
18	"created_by": {
19	"type": "sys_user",
20	"id": "created_by",
21	"display_id": "created_by",
22	"display_name": "created_by",
23	"display_picture": {
24	"id": "id"
25	},
26	"email": "created_by",
27	"full_name": "created_by",
28	"state": "active"
29	},
30	"created_date": "2023-01-01T12:00:00Z",
31	"custom_fields": {
32	"key": "value"
33	},
34	"custom_schema_fragments": [
35	"don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>"
36	],
37	"description": "description",
38	"display_id": "display_id",
39	"display_name": "display_name",
40	"domains": [
41	"domains"
42	],
43	"modified_by": {
44	"type": "sys_user",
45	"id": "modified_by",
46	"display_id": "modified_by",
47	"display_name": "modified_by",
48	"display_picture": {
49	"id": "id"
50	},
51	"email": "modified_by",
52	"full_name": "modified_by",
53	"state": "active"
54	},
55	"modified_date": "2023-01-01T12:00:00Z",
56	"stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>",
57	"subtype": "subtype",
58	"tags": [
59	{
60	"tag": {
61	"id": "id",
62	"name": "name"
63	}
64	}
65	],
66	"tier": "tier"
67	},
68	"default_rev_org": {
69	"id": "id",
70	"account": {
71	"id": "id",
72	"display_id": "display_id",
73	"display_name": "display_name"
74	},
75	"artifacts": [
76	{
77	"id": "id"
78	}
79	],
80	"created_by": {
81	"type": "sys_user",
82	"id": "created_by",
83	"display_id": "created_by",
84	"display_name": "created_by",
85	"display_picture": {
86	"id": "id"
87	},
88	"email": "created_by",
89	"full_name": "created_by",
90	"state": "active"
91	},
92	"created_date": "2023-01-01T12:00:00Z",
93	"custom_fields": {
94	"key": "value"
95	},
96	"custom_schema_fragments": [
97	"don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>"
98	],
99	"description": "description",
100	"display_id": "display_id",
101	"display_name": "display_name",
102	"domain": "domain",
103	"external_ref": "external_ref",
104	"modified_by": {
105	"type": "sys_user",
106	"id": "modified_by",
107	"display_id": "modified_by",
108	"display_name": "modified_by",
109	"display_picture": {
110	"id": "id"
111	},
112	"email": "modified_by",
113	"full_name": "modified_by",
114	"state": "active"
115	},
116	"modified_date": "2023-01-01T12:00:00Z",
117	"stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>",
118	"subtype": "subtype",
119	"tags": [
120	{
121	"tag": {
122	"id": "id",
123	"name": "name"
124	}
125	}
126	]
127	}
128	}