Skip to main content

Create New Account

POST /v1/account

Creates a new account in the system with the provided account details. The endpoint validates the input data, applies default values for missing optional fields, and returns the newly created account object with all generated identifiers and timestamps.

Query Parameters​

  • flow - Parameter for flow
  • registry - Parameter for registry

Request Example​

POST /v1/account?flow=manual&registry=undefined

Request Body​

{
    "name": "example Account",
    "number": "1000",
    "country": "NO",
    "address": {
      "line1": "Line 1",
      "city": "City",
      "zip": "0001",
      "line2": "Line 2",
      "country": "NO"
    }
  }

Response Example​

{
  "status": { "active": true },
  "type": "customer",
  "number": "1000",
  "country": "NO",
  "name": "Example Account",
  "address": {
    "postal": {
      "street": "Line 1",
      "line2": "Line 2",
      "zip": "0001",
      "city": "City",
      "country": "NO"
    },
    "delivery": {
      "street": "Line 1",
      "line2": "Line 2",
      "zip": "0001",
      "city": "City",
      "country": "NO"
    },
    "invoice": {
      "street": "Line 1",
      "line2": "Line 2",
      "zip": "0001",
      "city": "City",
      "country": "NO"
    },
    "official": {
      "street": "Line 1",
      "line2": "Line 2",
      "zip": "0001",
      "city": "City",
      "country": "NO"
    },
    "visit": {
      "street": "Line 1",
      "line2": "Line 2",
      "zip": "0001",
      "city": "City",
      "country": "NO"
    }
  },
  "email": { "default": null },
  "bankaccount": [],
  "contacts": [],
  "_id": "record-id-1",
  "integrations": [],
  "accountmanager": "user-id-1",
  "primaryuser": null,
  "tenant": "tenant-id-1",
  "created": "2025-10-30T09:58:51.599Z",
  "updated": "2025-10-30T09:58:51.599Z",
  "__v": 0,
  "id": "record-id-1"
}