accounts

Create

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

Request

This endpoint expects an object.
display_name
stringRequired
Name of the account.
artifacts
list of stringsOptional
The IDs of the artifacts to associate with the account.
custom_fields
map from strings to anyOptional
Application-defined custom fields.
description
stringOptional
Description of the account.
domains
list of stringsOptional
List of company's domain names. Example - ['devrev.ai'].
external_refs
list of stringsOptional
External refs are unique identifiers from your customer system of records, stored as a list.
owned_by
list of stringsOptional
List of Dev users owning this account.
schema_fragment_ids
list of stringsOptional
Schema fragment IDs associated with this account SOR.
tags
list of objectsOptional
Tags associated with the account.
tier
stringOptional
The tier of the account.
websites
list of stringsOptional
List of company websites. Example - ['www.devrev.ai', 'www.marketplace.devrev.ai'].

Response

This endpoint returns an object
account
object
default_rev_org
object
POST
1curl -X POST https://api.devrev.ai/accounts.create \
2 -H "Authorization: <apiKey>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "display_name": "display_name"
6}'
200
Successful
1{
2 "account": {
3 "external_refs": [
4 "external_refs"
5 ],
6 "id": "id",
7 "owned_by": [],
8 "artifacts": [
9 {
10 "id": "id"
11 }
12 ],
13 "created_date": "2023-01-01T12:00:00Z",
14 "custom_fields": {
15 "custom_fields": {
16 "key": "value"
17 }
18 },
19 "custom_schema_fragments": [
20 "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>"
21 ],
22 "description": "description",
23 "display_id": "display_id",
24 "display_name": "display_name",
25 "domains": [
26 "domains"
27 ],
28 "modified_date": "2023-01-01T12:00:00Z",
29 "stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>",
30 "subtype": "subtype",
31 "tags": [
32 {
33 "tag": {
34 "id": "id",
35 "name": "name"
36 }
37 }
38 ],
39 "tier": "tier"
40 },
41 "default_rev_org": {
42 "id": "id",
43 "account": {
44 "id": "id",
45 "display_id": "display_id",
46 "display_name": "display_name"
47 },
48 "artifacts": [
49 {
50 "id": "id"
51 }
52 ],
53 "created_date": "2023-01-01T12:00:00Z",
54 "custom_fields": {
55 "custom_fields": {
56 "key": "value"
57 }
58 },
59 "custom_schema_fragments": [
60 "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>"
61 ],
62 "description": "description",
63 "display_id": "display_id",
64 "display_name": "display_name",
65 "domain": "domain",
66 "external_ref": "external_ref",
67 "modified_date": "2023-01-01T12:00:00Z",
68 "stock_schema_fragment": "don:core:<partition>:devo/<dev-org-id>:custom_type_fragment/<custom-type-fragment-id>",
69 "subtype": "subtype",
70 "tags": [
71 {
72 "tag": {
73 "id": "id",
74 "name": "name"
75 }
76 }
77 ]
78 }
79}