Create — 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.

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.

schema_fragment_idslist of stringsOptional

Schema fragment IDs associated with this account SOR.

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'].

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 "created_date": "2023-01-01T12:00:00Z", 4 "display_id": "display_id", 5 "id": "id", 6 "modified_date": "2023-01-01T12:00:00Z", 7 "display_name": "display_name", 8 "artifacts": [ 9 { 10 "id": "id" 11 } 12 ], 13 "custom_fields": { 14 "key": "value" 15 }, 16 "custom_schema_fragments": [ 17 "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>" 18 ], 19 "description": "description", 20 "domains": [ 21 "domains" 22 ], 23 "external_refs": [ 24 "external_refs" 25 ], 26 "owned_by": [], 27 "stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>", 28 "subtype": "subtype", 29 "tags": [ 30 { 31 "tag": { 32 "id": "id", 33 "name": "name" 34 } 35 } 36 ], 37 "tier": "tier" 38 }, 39 "default_rev_org": { 40 "created_date": "2023-01-01T12:00:00Z", 41 "display_id": "display_id", 42 "id": "id", 43 "modified_date": "2023-01-01T12:00:00Z", 44 "display_name": "display_name", 45 "account": { 46 "display_id": "display_id", 47 "id": "id", 48 "display_name": "display_name" 49 }, 50 "artifacts": [ 51 { 52 "id": "id" 53 } 54 ], 55 "custom_fields": { 56 "key": "value" 57 }, 58 "custom_schema_fragments": [ 59 "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>" 60 ], 61 "description": "description", 62 "domain": "domain", 63 "external_ref": "external_ref", 64 "stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>", 65 "subtype": "subtype", 66 "tags": [ 67 { 68 "tag": { 69 "id": "id", 70 "name": "name" 71 } 72 } 73 ] 74 } 75 }

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	"created_date": "2023-01-01T12:00:00Z",
4	"display_id": "display_id",
5	"id": "id",
6	"modified_date": "2023-01-01T12:00:00Z",
7	"display_name": "display_name",
8	"artifacts": [
9	{
10	"id": "id"
11	}
12	],
13	"custom_fields": {
14	"key": "value"
15	},
16	"custom_schema_fragments": [
17	"don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>"
18	],
19	"description": "description",
20	"domains": [
21	"domains"
22	],
23	"external_refs": [
24	"external_refs"
25	],
26	"owned_by": [],
27	"stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>",
28	"subtype": "subtype",
29	"tags": [
30	{
31	"tag": {
32	"id": "id",
33	"name": "name"
34	}
35	}
36	],
37	"tier": "tier"
38	},
39	"default_rev_org": {
40	"created_date": "2023-01-01T12:00:00Z",
41	"display_id": "display_id",
42	"id": "id",
43	"modified_date": "2023-01-01T12:00:00Z",
44	"display_name": "display_name",
45	"account": {
46	"display_id": "display_id",
47	"id": "id",
48	"display_name": "display_name"
49	},
50	"artifacts": [
51	{
52	"id": "id"
53	}
54	],
55	"custom_fields": {
56	"key": "value"
57	},
58	"custom_schema_fragments": [
59	"don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>"
60	],
61	"description": "description",
62	"domain": "domain",
63	"external_ref": "external_ref",
64	"stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>",
65	"subtype": "subtype",
66	"tags": [
67	{
68	"tag": {
69	"id": "id",
70	"name": "name"
71	}
72	}
73	]
74	}
75	}