> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# User

The user file is used to create and update users on the MX platform. Usually, each `user` record will represent a given end-user. Details can be discussed with the MX integrations team.

## User File Parameters

<Note>
  The `action` field tells us what data operation to perform for each row in the file. Options are `upsert` (an insert/update depending on if the object already exists) and `delete` (which will destroy the record). If no action is provided the default action is `upsert`.
</Note>

<Note>
  The `skip_webhook` parameter prevents a webhook being sent for the action effected by each row. Accepted values are `true` or `false`. If `skip_webhook` is not provided, MX will default to your internal batch configuration setting.
</Note>

| Field          | Required for Upsert? | Required for Delete? | Type    |
| :------------- | :------------------- | :------------------- | :------ |
| `id`           | **Yes**              | **Yes**              | String  |
| `action`       | No                   | No                   | String  |
| `birthdate`    | No                   | No                   | String  |
| `credit_score` | No                   | No                   | String  |
| `email`        | No                   | No                   | String  |
| `first_name`   | No                   | No                   | String  |
| `gender`       | No                   | No                   | String  |
| `is_disabled`  | No                   | No                   | Boolean |
| `last_name`    | No                   | No                   | String  |
| `metadata`     | No                   | No                   | String  |
| `phone`        | No                   | No                   | String  |
| `skip_webhook` | No                   | No                   | Boolean |
| `zip_code`     | No                   | No                   | String  |

## Sample File

The following is a sample User batch CSV file.

```text CSV theme={null}
"action","id","first_name","last_name","email","phone"
"upsert","U-39XBF7","John","Smith","example@example.com","5055551234"
```