---
title: "Create a customer user"
method: POST
path: "/v1/partner/customers/{customerId}/users"
tags: ["Customer Users"]
---

# Create a customer user

`POST /v1/partner/customers/{customerId}/users`

Creates a new user account for a customer.

This endpoint provisions a user account with the specified role and associates it with the customer.

**Security:**
- Requires valid partner access token (Bearer token)

**Validation:**
- Email must be a valid email address
- First name and last name are required
- Role must be a valid CustomerUserRole enum value

## Path parameters

- `customerId` object, required

## Request body

- StrategicPartnerCustomerUserCreateRequest
  - `firstName` string, required — User's first name
  - `lastName` string, required — User's last name
  - `email` string, email, required — User's email address
  - `role` 'ADMIN' | 'BILLING_ADMIN' | 'PAYROLL_ADMIN' | 'HR_ADMIN' | 'MANAGER', required — User's role within the customer: - ADMIN: Administrator user to fully manage customer account - BILLING_ADMIN: Billing administrator user to manage customer billing - PAYROLL_ADMIN: Payroll administrator user to manage customer payroll - HR_ADMIN: HR administrator user to manage customer HR

## Response `201`

Customer user created successfully

- StrategicPartnerCustomerUserResponse
  - `id` string, required — Unique customer user identifier
  - `firstName` string — User's first name
  - `lastName` string — User's last name
  - `email` string, email, required — User's email address
  - `role` 'ADMIN' | 'BILLING_ADMIN' | 'PAYROLL_ADMIN' | 'HR_ADMIN' | 'MANAGER', required — User's role within the customer: - ADMIN: Administrator user to fully manage customer account - BILLING_ADMIN: Billing administrator user to manage customer billing - PAYROLL_ADMIN: Payroll administrator user to manage customer payroll - HR_ADMIN: HR administrator user to manage customer HR
  - `customerId` string, required — Customer ID this user belongs to

## Other responses

- `400` — Bad Request - Validation failed
- `401` — Unauthorized - Missing or invalid authentication
- `404` — Not Found - Resource does not exist
- `409` — Conflict - Resource already exists or state conflict
- `500` — Internal Server Error - Unexpected server error

---

[API](https://skmtc.net/usemultiplier/apis/multiplier-public-rest-api.md) · [All operations](https://skmtc.net/usemultiplier/apis/multiplier-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usemultiplier/multiplier-public-rest-api/revisions/59cd6443fdbf/schema)