Accounts

Create Account

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

POST
/accounts.create
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.

Formattext
display_namestring

Name of the account.

Formattext
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.

Formattext
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"
}