---
search:
  tags:
    - Merchant Users V2
    - POST
seo:
  description: >-
    Bulk-creates merchant users. Successful entities are… Reference for the POST
    /api/v2/{team_slug}/{app_slug}/merchant-users endpoint in the Management API
    v2.
sidebar:
  label: Create merchant users
  badge: POST
title: Create merchant users
type: openapi-operation
---
Bulk-creates merchant users. Successful entities are returned in data; per-item failures in errors keyed by email.

`POST /api/v2/{team_slug}/{app_slug}/merchant-users`

**Request body** (`application/json`, required)

- `merchant_users` (CreateMerchantUserItem[], required)

Request body example:

```json
{
  "merchant_users": [
    {
      "name": "string",
      "surname": "string",
      "email": "string",
      "language": "string",
      "market": "string",
      "store_group": "string",
      "phone_number": "string",
      "additions": {
        "property1": "string",
        "property2": "string"
      },
      "email_verified": true,
      "communication_preferences": {
        "allow_email": true,
        "allow_sms": true,
        "allow_postal": true
      },
      "address": {
        "street": "string",
        "zip_code": "string",
        "city": "string",
        "country": "string",
        "country_code": "string"
      },
      "status": "string",
      "comment": "string",
      "is_super_admin": true,
      "third_party_sign_up": true,
      "customer_group_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ]
    }
  ]
}
```

**Responses**

- `201` — Created (partial success possible)
- `400` — Request-level failure
- `401` — Request-level failure
- `403` — Request-level failure
- `500` — Request-level failure

Response example, 201:

```json
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "app_id": "affd1d10-9538-4fc8-9e0b-4594a28c1335",
      "name": "string",
      "surname": "string",
      "email": "string",
      "language": "string",
      "market": "string",
      "store_group": "string",
      "phone_number": "string",
      "additions": {
        "property1": "string",
        "property2": "string"
      },
      "email_verified": true,
      "email_verification_sent_at": "2019-08-24T14:15:22Z",
      "communication_preferences": {
        "allow_email": true,
        "allow_sms": true,
        "allow_postal": true
      },
      "address": {
        "street": "string",
        "zip_code": "string",
        "city": "string",
        "country": "string",
        "country_code": "string"
      },
      "status": "string",
      "comment": "string",
      "is_super_admin": true,
      "third_party_sign_up": true,
      "tags": [
        {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "key": "string",
          "name": "string",
          "status": "string",
          "filterable": true,
          "created_at": "2019-08-24T14:15:22Z",
          "updated_at": "2019-08-24T14:15:22Z"
        }
      ],
      "attributes": [
        {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "key": "string",
          "name": "string",
          "description": "string",
          "filterable": true,
          "translatable": true,
          "values": {
            "property1": {
              "value": "string",
              "type": "string",
              "translations": [
                {
                  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                  "locale": "string",
                  "value": "string"
                }
              ]
            },
            "property2": {
              "value": "string",
              "type": "string",
              "translations": [
                {
                  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                  "locale": "string",
                  "value": "string"
                }
              ]
            }
          }
        }
      ],
      "organisations": [
        {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "name": "string",
          "organisation_number": "string",
          "custom_role_id": "4f5deddb-3218-41fa-acf0-ef42cdc17a8c",
          "custom_role_slug": "string",
          "custom_role_name": "string",
          "level": "string"
        }
      ],
      "address_restrictions": [
        {
          "organisation_id": "9ec26450-a51e-40b1-a49f-e04045480fd5",
          "organisation_number": "string",
          "organisation_name": "string",
          "address_id": "a32b0e3d-a5f5-48d8-a572-6ae561815055",
          "formatted_address": "string"
        }
      ],
      "customer_groups": [
        {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "slug": "string",
          "name": "string"
        }
      ],
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "errors": [
    {
      "email": "string",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "message": "string"
    }
  ]
}
```