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

# Create a user

<div className="Goal">
  ## Goal

  Create a user in order that their payment information can be securely stored and reused across transactions.
</div>

## Steps

***

## Step 1: Create a user

<div className="What">
  <p className="bold-header">What you need to do</p>

  When a user who has not previously been registered with the API loads your application, create a new user by calling the API. This should be done once per user in your system.
</div>

#### How to do it

1. Make an authenticated request to the [create-user](./apireference/user/create-user) endpoint with the user’s identity information.
2. Persist the returned `id` in your database.

<RequestExample>
  ```bash Create User theme={null}
  curl --request POST \
    --url https://sandbox.pushcash.com/user \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '
  {
    "name": {
      "first": "Alfred",
      "last": "Hitchcock"
    },
    "email": "alfred@imdb.com",
    "address": {
      "address_line_1": "1609 10th Ave",
      "locality": "Bodega Bay",
      "administrative_area": "CA",
      "postal_code": "94923",
      "country": "US"
    },
    "date_of_birth": "1899-08-13",
    "government_id": {
      "type": "passport",
      "last4": "7349"
    },
    "phone_number": "(555) 681-3485",
    "tag": "4c8e6b4f",
    "identity_verified": true
  }
  '
  ```
</RequestExample>

<ResponseExample>
  ```json Create User - 200 OK theme={null}
  {
    "id": "user_lVpbPL0K1XIiHx0DxipRbD"
  }
  ```
</ResponseExample>

## Integration checklist

* Create a user only once per internal user
* Store the returned user's `id` alongside your internal user record
* Provide your internal user identifier in the `tag` field to ensure [idempotency](./api#idempotency)

## Next steps

Now that you are registering users with the API, learn how to add a new card and process a transaction for a user.