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

# Create end users

`POST /beta/endusers/bulk`

Create multiple end users in a single bulk action

## Request body

- CreateEndUsersInput
  - `data` CreateEndUserInput[]
    - `displayName` string — The contact's display name
    - `email` string — The contact's primary email address
    - `phoneNumber` string — The contact's primary phone number
    - `additionalEmails` string[] — Additional email addresses for the contact
    - `additionalPhoneNumbers` string[] — Additional phone numbers for the contact
    - `firstName` string — The contact's first name
    - `lastName` string — The contact's last name
    - `middleNames` string[] — The contact's middle names
    - `avatarUrl` string — The url from which to load the contact's avatar
    - `externalId` string — Custom external identifier for the contact

## Response `201`

The created end users

- CreateEndUsersOutput
  - `data` BulkActionOutcomeBulkErrorEndUser[]
    - union
      - BulkActionFailureBulkErrorEndUser
        - `error` union, required
          - EmptyPatchSet
            - `id` string, required
            - `message` string, required
          - ErrorResponse
            - `message` string, required
          - Infrastructure
            - `id` string, required
            - `message` string, required
          - Integrity
            - `id` string, required
            - `message` string, required
          - InvalidArgument
            - `message` string, required
          - NotFound1
            - `id` string, required
            - `message` string, required
          - Validation
            - `id` string
            - `message` string, required
      - BulkActionSuccessBulkErrorEndUser
        - `data` EndUser, required
          - `id` string, uuid, required — Unique identifier for the contact
          - `createdAt` string, date-time, required — Time when the contact was created
          - `displayName` string — The contact's display name
          - `email` string — The contact's primary email address
          - `phoneNumber` string — The contact's primary phone number
          - `additionalEmails` string[] — Additional email addresses for the contact
          - `additionalPhoneNumbers` string[] — Additional phone numbers for the contact
          - `firstName` string — The contact's first name
          - `lastName` string — The contact's last name
          - `middleNames` string[] — The contact's middle names
          - `avatarUrl` string — The url from which to load the contact's avatar
          - `externalId` string — Custom external identifier for the contact
          - `customAttributes` CustomAttribute[] — Custom attributes for the contact
            - `id` string, uuid, required
            - `name` string, required
            - `identifier` string, required
            - `value` union, required — AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text
              - …

## Other responses

- `400` — Invalid value extracted from request context, Invalid value for: body
- `500` — Internal failure during request processing

---

[API](https://skmtc.net/dixa/apis/dixa-api.md) · [All operations](https://skmtc.net/dixa/apis/dixa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dixa/dixa-api/revisions/5eaff14a2c46/schema)