---
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`

## Request

- Base URL: `https://api.usemultiplier.com`
- URL: `https://api.usemultiplier.com/v1/partner/customers/{customerId}/users`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/usemultiplier/apis/multiplier-public-rest-api/docs/v1/partner/customers/:customerId/users/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/usemultiplier/apis/multiplier-public-rest-api.md) - [All operations](https://skmtc.dev/usemultiplier/apis/multiplier-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usemultiplier/apis/multiplier-public-rest-api/revisions/da31bb6ec00d?raw)