---
title: "Create service account"
method: POST
path: "/users"
tags: ["Users"]
---

# Create service account

`POST /users`

Use when provisioning API access for automation, CI/CD pipelines, or headless integrations that need scoped API keys.

## Request body

- DtoCreateUserRequest
  - `roles` string[], required — Roles are required
  - `type` 'user' | 'service_account', required

## Response `201`

Created

- DtoUserResponse
  - `email` string — Empty for service accounts
  - `id` string
  - `roles` string[]
  - `tenant` DtoTenantResponse
    - `billing_details` DtoTenantBillingDetails
      - `address` DtoAddress
        - `address_city` string
        - `address_country` string
        - `address_line1` string
        - `address_line2` string
        - `address_postal_code` string
        - `address_state` string
      - `email` string
      - `help_email` string
      - `phone` string
    - `created_at` string
    - `id` string
    - `metadata` TypesMetadata
    - `name` string
    - `status` string
    - `updated_at` string
  - `type` 'user' | 'service_account'

## Other responses

- `400` — Invalid request
- `500` — Server error

---

[API](https://skmtc.dev/flexprice/apis/flexprice-api.md) · [All operations](https://skmtc.dev/flexprice/apis/flexprice-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flexprice/flexprice-api/revisions/97b15ca35ebf/schema)