Create Account

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": "foo" 6 }'

1 { 2 "account": { 3 "id": "foo", 4 "owned_by": [ 5 { 6 "display_id": "foo", 7 "id": "foo", 8 "display_name": "foo", 9 "display_picture": { 10 "display_id": "foo", 11 "id": "foo", 12 "file": { 13 "type": "foo", 14 "name": "foo", 15 "size": 42 16 } 17 }, 18 "email": "foo", 19 "full_name": "foo", 20 "state": "active" 21 } 22 ], 23 "artifacts": [ 24 { 25 "id": "foo", 26 "display_id": "foo", 27 "file": { 28 "type": "foo", 29 "name": "foo", 30 "size": 42 31 } 32 } 33 ], 34 "created_by": { 35 "display_id": "foo", 36 "id": "foo", 37 "display_name": "foo", 38 "display_picture": { 39 "display_id": "foo", 40 "id": "foo", 41 "file": { 42 "type": "foo", 43 "name": "foo", 44 "size": 42 45 } 46 }, 47 "email": "foo", 48 "full_name": "foo", 49 "state": "active" 50 }, 51 "created_date": "2023-01-01T12:00:00.000Z", 52 "custom_fields": {}, 53 "custom_schema_fragments": [ 54 "foo" 55 ], 56 "description": "foo", 57 "display_id": "foo", 58 "display_name": "foo", 59 "domains": [ 60 "foo" 61 ], 62 "external_refs": [ 63 "foo" 64 ], 65 "modified_by": { 66 "display_id": "foo", 67 "id": "foo", 68 "display_name": "foo", 69 "display_picture": { 70 "display_id": "foo", 71 "id": "foo", 72 "file": { 73 "type": "foo", 74 "name": "foo", 75 "size": 42 76 } 77 }, 78 "email": "foo", 79 "full_name": "foo", 80 "state": "active" 81 }, 82 "modified_date": "2023-01-01T12:00:00.000Z", 83 "primary_account": { 84 "id": "foo", 85 "display_id": "foo", 86 "display_name": "foo" 87 }, 88 "stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id", 89 "subtype": "foo", 90 "tags": [ 91 { 92 "tag": { 93 "id": "foo", 94 "name": "foo", 95 "display_id": "foo", 96 "style_new": { 97 "color": "foo" 98 } 99 }, 100 "value": "foo" 101 } 102 ], 103 "tier": "foo", 104 "websites": [ 105 "foo" 106 ] 107 }, 108 "default_rev_org": { 109 "id": "foo", 110 "account": { 111 "id": "foo", 112 "display_id": "foo", 113 "display_name": "foo" 114 }, 115 "artifacts": [ 116 { 117 "id": "foo", 118 "display_id": "foo", 119 "file": { 120 "type": "foo", 121 "name": "foo", 122 "size": 42 123 } 124 } 125 ], 126 "created_by": { 127 "display_id": "foo", 128 "id": "foo", 129 "display_name": "foo", 130 "display_picture": { 131 "display_id": "foo", 132 "id": "foo", 133 "file": { 134 "type": "foo", 135 "name": "foo", 136 "size": 42 137 } 138 }, 139 "email": "foo", 140 "full_name": "foo", 141 "state": "active" 142 }, 143 "created_date": "2023-01-01T12:00:00.000Z", 144 "custom_fields": {}, 145 "custom_schema_fragments": [ 146 "foo" 147 ], 148 "description": "foo", 149 "display_id": "foo", 150 "display_name": "foo", 151 "external_ref": "foo", 152 "modified_by": { 153 "display_id": "foo", 154 "id": "foo", 155 "display_name": "foo", 156 "display_picture": { 157 "display_id": "foo", 158 "id": "foo", 159 "file": { 160 "type": "foo", 161 "name": "foo", 162 "size": 42 163 } 164 }, 165 "email": "foo", 166 "full_name": "foo", 167 "state": "active" 168 }, 169 "modified_date": "2023-01-01T12:00:00.000Z", 170 "primary_rev_org": { 171 "display_id": "foo", 172 "id": "foo", 173 "display_name": "foo" 174 }, 175 "stock_schema_fragment": "don:core:dvrv-us-1:devo/example:custom_type_fragment/custom-type-fragment-id", 176 "subtype": "foo", 177 "tags": [ 178 { 179 "tag": { 180 "id": "foo", 181 "name": "foo", 182 "display_id": "foo", 183 "style_new": { 184 "color": "foo" 185 } 186 }, 187 "value": "foo" 188 } 189 ], 190 "domain": "foo" 191 } 192 }

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

Request

This endpoint expects an object.

display_namestringRequiredformat: "text"

Name of the account.

artifactslist of stringsOptional

The IDs of the artifacts to associate with the account.

custom_fieldsobjectOptional

Application-defined custom fields.

custom_schema_specobjectOptional

Custom schemas described using identifiers. Each custom field in the request must have the corresponding schema specified; omission results in a Bad Request error. If a custom schema is not included in the specifier, it remains unchanged. For surfaces with human interactors, it is recommended to provide tenant_fragment: true and validate_required_fields: true.

descriptionstringOptionalformat: "text"

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.

tierstringOptionalformat: "text"

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

The response to creating a new account.

accountobject

default_rev_orgobject

Headers

Request

Response

Errors