---
title: "Create Account (Team Member)"
method: POST
path: "/v3/account"
---

# Create Account (Team Member)

`POST /v3/account`

Create a new account (team member) for this merchant (Administrator role only).

## Query parameters

- `echo` boolean

## Request body

- object
  - `active` boolean, required — Is this user active?
  - `saleLimit` number, float — Highest payment amount this user can make
  - `refundLimit` number, float — Highest refund amount this user can make
  - `timeRestriction` object
    - `sunday` boolean
    - `monday` boolean
    - `tuesday` boolean
    - `wednesday` boolean
    - `thursday` boolean
    - `friday` boolean
    - `saturday` boolean
    - `startTimeMinute` string
    - `endTimeMinute` string
  - `merchants` object[], required — Merchants that this user can access
    - `id` string, required — Merchant Id
    - `dba` string — Merchant's name
    - `xmid` string — XMID of the Merchant
  - `role` string, required — What role does this user need? Values: Administrator, Supervisor, Read Only, Clerk, No Access
  - `username` string, required — Username of the new user
  - `firstName` string — User's first name
  - `lastName` string — User's last name
  - `email` string — User's email address
  - `mobile` string — User's phone number
  - `password` string — User's new or temporary password

## Response `201`

201

- object
  - `active` boolean
  - `saleLimit` integer
  - `refundLimit` integer
  - `timeRestriction` object
    - `sunday` boolean
    - `monday` boolean
    - `tuesday` boolean
    - `wednesday` boolean
    - `thursday` boolean
    - `friday` boolean
    - `saturday` boolean
    - `startTimeMinute` integer
    - `endTimeMinute` integer
  - `photo` string
  - `merchants` object[]
    - `id` integer
    - `dba` string
    - `xmid` integer
    - `applicationStatus` string
    - `awaitingMerchantAcceptance` boolean
    - `merchantAcceptedAgreement` boolean
    - `hasPayRightHealthEquipment` boolean
    - `plan` string
    - `package` string[]
    - `canProcessPayment` boolean
    - `address` object
      - `name` string
      - `address1` string
      - `city` string
      - `state` string
      - `zip` string
      - `country` string
    - `spendProfiles` object[]
  - `role` string
  - `username` string
  - `firstName` string
  - `lastName` string
  - `email` string
  - `mobile` string
  - `password` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/mxmerchant/apis/checkout-api.md) · [All operations](https://skmtc.net/mxmerchant/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mxmerchant/checkout-api/versions/6807b698abcb/schema)