Create

POST

Creates a Rev organization in the authenticated user’s Dev organization.

Request

This endpoint expects an object.

display_namestringRequired

Name of the Rev organization.

descriptionstringOptional

Description of the Rev organization.

environmentenumOptional

Allowed values: productionstagingtest

The environment of the Org. Defaults to ‘production’ if not specified.

external_refstringOptional

External ref is a custom unique identifier which is a reference to an unique id for this organization’s data in some system of records.

tierstringOptional

The tier of the RevOrg.

domainstringOptionalDeprecated

Company’s domain name. Example - ‘devrev.ai’.

Response

This endpoint returns an object.

rev_orgobject

POST

1 curl -X POST https://api.devrev.ai/rev-orgs.create \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "display_name": "display_name"
6 }'

200Successful

1 {
2   "rev_org": {
3     "id": "id",
4     "created_by": {
5       "type": "sys_user",
6       "id": "created_by",
7       "display_id": "created_by",
8       "display_name": "created_by",
9       "display_picture": {
10         "id": "id"
11       },
12       "email": "created_by",
13       "full_name": "created_by",
14       "state": "active"
15     },
16     "created_date": "2023-01-01T12:00:00Z",
17     "description": "description",
18     "display_id": "display_id",
19     "display_name": "display_name",
20     "domain": "domain",
21     "external_ref": "external_ref",
22     "modified_by": {
23       "type": "sys_user",
24       "id": "modified_by",
25       "display_id": "modified_by",
26       "display_name": "modified_by",
27       "display_picture": {
28         "id": "id"
29       },
30       "email": "modified_by",
31       "full_name": "modified_by",
32       "state": "active"
33     },
34     "modified_date": "2023-01-01T12:00:00Z"
35   }
36 }

Built with

1	curl -X POST https://api.devrev.ai/rev-orgs.create \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"display_name": "display_name"
6	}'

1	{
2	"rev_org": {
3	"id": "id",
4	"created_by": {
5	"type": "sys_user",
6	"id": "created_by",
7	"display_id": "created_by",
8	"display_name": "created_by",
9	"display_picture": {
10	"id": "id"
11	},
12	"email": "created_by",
13	"full_name": "created_by",
14	"state": "active"
15	},
16	"created_date": "2023-01-01T12:00:00Z",
17	"description": "description",
18	"display_id": "display_id",
19	"display_name": "display_name",
20	"domain": "domain",
21	"external_ref": "external_ref",
22	"modified_by": {
23	"type": "sys_user",
24	"id": "modified_by",
25	"display_id": "modified_by",
26	"display_name": "modified_by",
27	"display_picture": {
28	"id": "id"
29	},
30	"email": "modified_by",
31	"full_name": "modified_by",
32	"state": "active"
33	},
34	"modified_date": "2023-01-01T12:00:00Z"
35	}
36	}