Create

POST

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

This endpoint returns an object.

accountobject

POST

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 }'

200Successful

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     "created_by": {
14       "type": "sys_user",
15       "id": "created_by",
16       "display_id": "created_by",
17       "display_name": "created_by",
18       "display_picture": {
19         "id": "id"
20       },
21       "email": "created_by",
22       "full_name": "created_by",
23       "state": "active"
24     },
25     "created_date": "2023-01-01T12:00:00Z",
26     "description": "description",
27     "display_id": "display_id",
28     "display_name": "display_name",
29     "domains": [
30       "domains"
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   }
47 }

Built with

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	"created_by": {
14	"type": "sys_user",
15	"id": "created_by",
16	"display_id": "created_by",
17	"display_name": "created_by",
18	"display_picture": {
19	"id": "id"
20	},
21	"email": "created_by",
22	"full_name": "created_by",
23	"state": "active"
24	},
25	"created_date": "2023-01-01T12:00:00Z",
26	"description": "description",
27	"display_id": "display_id",
28	"display_name": "display_name",
29	"domains": [
30	"domains"
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	}
47	}