# Create account

URL: /en/docs/api/v1/accounts/post
Last Updated: 2026-07-30T21:15:44.917Z

## Description
No description available.

## Available Actions
- Execute POST request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### POST /api/v1/accounts

**Create account**

Create a new customer account with optional contacts and initial configuration.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Request body** (`application/json`) - required:

- `title` (string, required): Account/company name
- `description` (string): Account description or notes
- `review_status` (enum: to_review | in_review | approved | cancelled): Initial review status
- `auto_approval` (boolean): Whether to automatically approve access requests from this account's domain
- `contacts` (array of object): Initial contact persons to create
  - `email` (string (email), required): Contact email address
  - `first_name` (string, required): Contact first name
  - `last_name` (string): Contact last name
  - `title` (string): Contact job title

Example (Basic account without contacts):

```json
{
  "title": "Acme Corporation",
  "description": "Enterprise customer account",
  "review_status": "to_review"
}
```

Example (Account with auto-approval enabled):

```json
{
  "title": "TechCorp Inc",
  "description": "Technology partner with verified domain",
  "review_status": "approved",
  "auto_approval": true
}
```

Example (Account with initial contacts):

```json
{
  "title": "Burger King EU",
  "description": "Fast-food chain European division",
  "review_status": "in_review",
  "contacts": [
    {
      "email": "john.doe@burgerking.com",
      "first_name": "John",
      "last_name": "Doe",
      "title": "Compliance Manager"
    },
    {
      "email": "jane.smith@burgerking.com",
      "first_name": "Jane",
      "last_name": "Smith",
      "title": "Security Officer"
    }
  ]
}
```

**Responses:**

- `201` - Account created successfully
  - `success` (boolean)
  - `data` (object)
    - `account` (Account (object))
      - `id` (string (uuid)): Unique account identifier
      - `title` (string): Account/company name
      - `description` (string): Account description or notes
      - `review_status` (enum: to_review | in_review | approved | cancelled): Current review status for compliance
      - `sfdc_account_id` (string): Salesforce account ID for integration
      - `domain` (string): Primary domain for the account
      - `logo` (string): URL to account logo
      - `access_expiry_datetime` (string (date-time)): When account access expires
      - `nda` (boolean): Whether NDA is required for this account
      - `type` (enum: standard | enterprise): Account tier/type
      - `internal_notes` (string): Internal notes not visible to account users
      - `auto_approval` (boolean): Whether to automatically approve access requests from this account's domain
      - `date_created` (string (date-time)): Account creation timestamp
      - `contacts` (array of Contact (object)): Associated contact persons
        - `id` (string (uuid)): Contact identifier
        - `email` (string (email)): Contact email address
        - `first_name` (string): Contact first name
        - `last_name` (string): Contact last name
        - `title` (string): Contact job title
- `400` - Bad Request - validation failed
  - `error` (string): Validation error message

  Example (Validation Error):
  
  ```json
  {
  "error": "Invalid input: title: String must contain at least 1 character(s)"
}
  ```

  Example (Missing Required Field):
  
  ```json
  {
  "error": "Invalid input: title: Account name is required."
}
  ```
- `401` - Unauthorized
- `409` - Conflict - account with similar details already exists
- `500` - Internal server error

**Code samples:**

cURL:

```bash
curl -X POST "https://app.orbiqhq.com/api/v1/accounts" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Acme Corporation",
  "description": "Enterprise customer account",
  "review_status": "in_review"
}'
```