Create Account

​

Create a new account with optional MMS setup (Clerk org, SVIX, API key)

Headers
  • Accept
    enum
    const:  
    application/json
    required

    Response format. Must be application/json.

    values
    • application/json
  • Content-Type
    enum
    const:  
    application/json
    required

    Request payload format. Must be application/json when a body is sent.

    values
    • application/json
Body
required
application/json
  • address
    Type: object · Address
    required
  • description
    Type: string · Description
    required
  • name
    Type: string · Name
    required
  • type
    Type: string · AccountTypeenum
    required
    values
    • admin
    • psp
    • partner
    • merchant
  • admin_email
    Type: string | null · Admin Email
  • admin_first_name
    Type: string | null · Admin First Name
  • admin_last_name
    Type: string | null · Admin Last Name
  • available_processor_configs
    Type: array string[] · Available Processor Configs
  • has_access_to_mms
    Type: boolean | null · Has Access To Mms
  • mcc
    Type: string | null · Mcc
  • parent_id
    Type: string | null · Parent Id
  • surcharge_rate
    Type: number | null · Surcharge Rate

    Surcharge percentage for merchant accounts (e.g., 3.5 for 3.5%). Setting to null disables automatic surcharge logic. Setting to 0 means surcharges will NEVER be applied unless explicitly overridden.

Responses
  • application/json
  • application/json
Request Example for post/v2/accounts
curl https://api.uat.koard.com/v2/accounts \
  --request POST \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'x-koard-apikey: YOUR_SECRET_TOKEN' \
  --data '{
  "address": {
    "city": "",
    "state": "",
    "street_line1": "",
    "street_line2": "",
    "zip": ""
  },
  "admin_email": null,
  "admin_first_name": null,
  "admin_last_name": null,
  "available_processor_configs": [
    ""
  ],
  "description": "",
  "has_access_to_mms": false,
  "mcc": null,
  "name": "",
  "parent_id": null,
  "surcharge_rate": null,
  "tax_id": null,
  "type": "admin"
}'

{
  "address": {
    "city": "string",
    "state": "string",
    "street_line1": "string",
    "street_line2": "",
    "zip": "string"
  },
  "available_processor_configs": [],
  "created_at": "2026-04-08T04:11:41.530Z",
  "deleted_at": null,
  "description": "string",
  "has_access_to_apple_config": false,
  "has_access_to_mms": false,
  "id": "string",
  "mcc": null,
  "name": "string",
  "organization_id": null,
  "parent_account_ids": [],
  "status": "active",
  "surcharge_rate": null,
  "tax_id": null,
  "type": "admin",
  "updated_at": null
}

Successful Response