---
title: "Create end user"
method: POST
path: "/end-users"
tags: ["End Users"]
---

# Create end user

`POST /end-users`

Create an end user.

## Request body

- EndUserCreate
  - `name` string, required
  - `address` object, required
    - `country` string, required — ISO 3166-1 alpha-2 country code
    - `city` string
  - `comment` string

## Response `201`

End user created

- EndUser
  - `name` string, required
  - `address` object, required
    - `country` string, required — ISO 3166-1 alpha-2 country code
    - `city` string
  - `comment` string
  - `sid` string, required — Short ID
  - `type` 'self' | 'third-party', required — The type of end user. It can be either **self** (your company) or **third-party**. Any end user you create is considered as third-party.
  - `created` string, date-time, required — RFC 3339, section 5.6
  - `updated` string, date-time, required — RFC 3339, section 5.6
  - `deletable` boolean — Whether the end user can be deleted or not. Self end user cannot be deleted. Third party end users can be deleted if they are not associated with any phone number.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `405` — Method Not Allowed
- `429` — Too Many Requests (rate limit exceeded)
- `500` — Internal Server Error

---

[API](https://skmtc.net/callr/apis/callr-rest-api-v2-0.md) · [All operations](https://skmtc.net/callr/apis/callr-rest-api-v2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/callr/callr-rest-api-v2-0/versions/76d36d004a8f/schema)