---
page_title: Create a customer
product: lotuspay
platform: web
page_source: https://docs.juspay.io/lotuspay/web/core-resources/create-a-customer
openapi: https://docs.juspay.io/api/swagger?document=https%3A%2F%2Fdocs.juspay.io%2Flotuspay%2Fweb%2Fcore-resources%2Fcreate-a-customer
llms_txt: https://docs.juspay.io/llms.txt
product_llms_txt: https://docs.juspay.io/lotuspay/llms.txt
---

## API Version: default


# **Create a customer** 



Creates a new customer object.

**ARGUMENTS** 


| Argument | Description |
|---|---|
| metadata optional	 | A set of key/value pairs that you can attach to a customer object. It can be useful for storing additional information about the customer in a structured format. |
| email optional	 | Customer’s email address. It’s displayed alongside the customer in your dashboard and can be useful for searching and tracking. This may be up to 512 characters. |
| id optional	 | Customer's identification number e.g. Permanent Account Number (tax ID in India). |
| mobile optional	 | Customer's mobile number. |
| name optional	 | Customer's name. Can be different to their bank account name. |
| phone optional	 | Customer's phone. |


**Returns**  Returns a customer object if valid arguments were provided.## Endpoints:
- Sandbox: https://api-test.lotuspay.com/v1/customers/

- Production: https://api.lotuspay.com/v1/customers/

## Request Type: 
POST

## Content-Type: 
application/json

## Authorization:

#### Basic Auth:
Auth example
- Value:  sk_test_XjIHowXWSI23uvjepz2X82
## Sample Code Snippets:
### Sample Request and Response:

#### Request:
```Shell
$ curl https://api-test.lotuspay.com/v1/customers/CU004433221AA \
    -u sk_test_XjIHowXWSI23uvjepz2X82:
    -d email="test@lotuspay.com" \
    -d mobile="+91-9123456789" \
    -d name="Amit Jain" \
    -d pan="ABCDE1234A"

```

#### Response:
```json
{
    "id": "CU004433221AA",
    "object": "customer",
    "created": 1530224170,
    "livemode": false,
    "metadata": {
    },
    "bank_accounts": {
      "object": "list",
      "data": [
      ],
      "total_count": 0,
      "url": "/v1/customers/CU004433221AA/bank_accounts"
    },
    "description": null,
    "email": "test@lotuspay.com",
    "identification": "ABCDE1234A",
    "mandates": {
      "object": "list",
      "data": [
      ],
      "total_count": 0,
      "url": "/v1/customers/CU004433221AA/mandates"
      },
    "mobile": "9123456789",
    "name": "Amit Jain",
    "phone": "9123456789",
    "subscriptions": {
      "object": "list",
      "data": [
      ],
      "total_count": 0,
      "url": "/v1/customers/CU004433221AA/subscriptions"
    }
  }
```

## API Responses: