# Create End User

Add someone from your product so they can connect their own accounts through Embedded.

`POST https://connect.mindcloud.co/v2/embedded/end-users`

Permissions: `embedded:create`.

## Parameters

### Body

- `externalId` (string): Your own id for them, up to 48 characters.
- `name` (string): Their name.
- `email` (string): Their email address.
- `metadata` (object): Credential-exchange host variables: each value a host label.
  Host variables for credential exchange: { name: value }, each value a host label (letters, digits and hyphens, up to 63 characters), such as { "environment": "eu1" }.

## Example request

```bash
curl --request POST \
  --url 'https://connect.mindcloud.co/v2/embedded/end-users' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "externalId": "cust_8842",
  "name": "Jordan Lee",
  "email": "jordan@customer.com",
  "metadata": {
    "environment": "eu1"
  }
}'
```

## Response fields

- `id` (string): Unique id of the end user. Use it in the end user routes, connect links, and the embedded MCP route.
- `externalId` (string): Your own id for them, such as the user id in your product.
- `name` (string): Their name.
- `email` (string): Their email address.
- `metadata` (object): Your values for them, used as credential-exchange host variables. Each value is a host label (letters, digits, hyphens).
- `createdOn` (date): When the end user was created.
- `updatedOn` (date): When they were last changed.