Accounts
Create Account
Creates an account, which is a record representing a customer or an organization.
AuthorizationBearer <token>
All the DevRev APIs require a token to authenticate the user. Provide Authorization: Bearer <TOKEN>
as a header to every API request.
How do I find my token?
In: header
description?string
Description of the account.
Format
text
display_namestring
Name of the account.
Format
text
domains?array<string>
List of company's domain names. Example - ['devrev.ai'].
external_refs?array<string>
External refs are unique identifiers from your customer system of records, stored as a list.
owned_by?array<string>
List of Dev users owning this account.
tier?string
The tier of the account.
Format
text
websites?array<string>
List of company websites. Example - ['www.devrev.ai', 'www.marketplace.devrev.ai'].
Response Body
curl -X POST "https://api.devrev.ai/accounts.create" \ -H "Content-Type: application/json" \ -d '{ "display_name": "string" }'
{
"account": {
"created_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"created_date": "2023-01-01T12:00:00.000Z",
"display_id": "string",
"id": "string",
"modified_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"modified_date": "2023-01-01T12:00:00.000Z",
"display_name": "string",
"description": "string",
"domains": [
"string"
],
"external_refs": [
"string"
],
"owned_by": [
{
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
}
],
"primary_account": {
"display_id": "string",
"id": "string",
"display_name": "string"
},
"tier": "string",
"websites": [
"string"
]
}
}
{
"detail": "string",
"message": "string",
"type": "artifact_already_attached_to_a_parent",
"existing_parent": "string",
"is_same": true
}
{
"detail": "string",
"message": "string",
"type": "unauthenticated"
}
{
"detail": "string",
"message": "string",
"type": "forbidden"
}
{
"detail": "string",
"message": "string",
"type": "conflict"
}
{
"detail": "string",
"message": "string",
"type": "too_many_requests",
"retry_after": 0
}
{
"detail": "string",
"message": "string",
"type": "internal_error",
"reference_id": "string"
}
{
"detail": "string",
"message": "string",
"type": "service_unavailable"
}