# POST New

#### `POST /participants/customers/new` <a href="#post-participants-customers-new" id="post-participants-customers-new"></a>

```
const postParticipantCustomer = () => {
  const body = {
    request_id: "7fbab305-2679-4279-808b-9b7a63a55c85",
    first_name: "Gaurav",
    last_name: "Mehta",
    address_one: "Near CST",
    address_two: "Fort",
    country: "India",
    signed_timestamp: "1603378501286",
    email: "gewgawrav@gmail.com",
    metadata: {},
    state: "MH",
    city: "MUMBAI",
    date_of_birth: "1989-10-13",
    id_number_type: "Passport",
    id_number: "123456789",
    zip: "12345",
    prefunded: false
  }
  const timestamp = Math.round(Date.now() / 1000)
  const payload = timestamp + 'POST' + '/participants/customers/new' + JSON.stringify(body)
  const decodedSecret = Buffer.from(apiSecret, 'base64')
  const hmac = crypto.createHmac('sha256', decodedSecret)
  const signedPayload = hmac.update(payload).digest('base64')

  // SET HEADERS
 const headers = {
    'X-NDAX-API-KEY': 'public_key',
    'X-NDAX-SIGNED': signedPayload,
    'X-NDAX-TIMESTAMP': timestamp,
    'X-NDAX-PASSPHRASE': 'passphrase'
  }
  const options = {
    headers,
    body,
    json: true
  }

  return request.post(
    `https://api.ndax.in/participants/customers/new`,
    options
  )
}
```

> Sample Request

```
{
  "request_id": "7fbab305-2679-4279-808b-9b7a63a55c85",
  "first_name": "John",
  "last_name": "Smith",
  "email": "email-example@mail.com",
  "address_one": "1 Main St.",
  "address_two": "Suite 1000",
  "city": "Chicago",
  "state": "IL",
  "zip": "12345",
  "country": "United States",
  "date_of_birth": "1985-09-02",
  "id_number_type": "ssn",
  "id_number": "123456789",
  "signed_timestamp": 1603378501286,
  "prefunded": false,
  "metadata": {}
}
```

> Sample Response

```
{
  "message": {
    "first_name": "John",
    "last_name": "Smith",
    "email": "email-example@mail.com",
    "address_one": "1 Main St.",
    "address_two": "Suite 1000",
    "country": "United States",
    "state": "IL",
    "city": "Chicago",
    "zip": "12345",
    "date_of_birth": "1985-09-02",
    "id_number_type": "ssn",
    "id_number": "123456789",
    "non_us_other_type": null,
    "id_issuing_authority": null,
    "signed_timestamp": 1603378501286,
    "risk_rating": null,
    "metadata": {},
    "platform_code": "ABC123",
    "participant_code": "XYZ456"
  }
}
```

&#x20;This endpoint is only available to certain participants leveraging NDAX for customer settlements. Please contact us for more information on enabling this endpoint.

Submits a customer to your platform.

Request body:

<table><thead><tr><th width="172.33333333333331">Parameter</th><th width="435">Description</th><th>Type</th></tr></thead><tbody><tr><td>request_id</td><td>A universally unique identifier (UUID) for this request, optional<br>Note: To ensure idempotence, it is recommended to include this parameter</td><td>string</td></tr><tr><td>first_name</td><td>The first name of the customer, required</td><td>string</td></tr><tr><td>last_name</td><td>The last name of the customer, required</td><td>string</td></tr><tr><td>email</td><td>Customer email address, required<br>Note: NDAX will validate that the <code>email</code> is a correctly formatted email, and that the value is unique per-platform</td><td>string</td></tr><tr><td>address_one</td><td>First line for the customer's address, required<br>Note: PO Box addresses are not accepted</td><td>string</td></tr><tr><td>address_two</td><td>First line for the customer's address, if applicable, optional</td><td>string</td></tr><tr><td>city</td><td>The city customer resides in, required</td><td>string</td></tr><tr><td>state</td><td>The state the customer resides in, required if country is "India"<br>Note: must be one of the supported states</td><td>string</td></tr><tr><td>zip</td><td>Zip code of the customer in the format <code>&#x3C;5digits></code> or <code>&#x3C;5digits>-&#x3C;4digits></code>, e.g. <code>77777</code> or <code>77777-7777</code>, required if country is "United States"</td><td>string</td></tr><tr><td>country</td><td>The country the customer resides in, required<br>Note: must be one of the supported countries.</td><td>string</td></tr><tr><td>date_of_birth</td><td>Date of birth of the customer in the format <code>YYYY-MM-DD</code>, required</td><td>string</td></tr><tr><td>id_number_type</td><td>The type of ID document provided, required<br>Note: must be one of the supported ID types</td><td>string</td></tr><tr><td>id_number</td><td>The ID number for the customer, required</td><td>string</td></tr><tr><td>non_us_other_type</td><td>This is required if you select <code>non_us_other</code> for the <code>id_number_type</code> - a freeform string to describe the ID type</td><td>string</td></tr><tr><td>id_issuing_authority</td><td>The issuing authority for the ID, if available, optional</td><td>string</td></tr><tr><td>risk_rating</td><td>The risk-rating associated with the customer, conditionally required for certain platforms</td><td>string</td></tr><tr><td>signed_timestamp</td><td>The UNIX timestamp (in milliseconds) when the NDAX Services Agreement was accepted by the participant</td><td>timestamp</td></tr><tr><td>prefunded</td><td>Indicates if a customer will be credit checked through their own account or through an omnibus account</td><td>boolean</td></tr><tr><td>metadata</td><td>Can be used to submit any additional unstructed metadata</td><td>object</td></tr></tbody></table>

Additional fields in response:

<table><thead><tr><th width="181.33333333333331">Parameter</th><th width="432">Description</th><th>Type</th></tr></thead><tbody><tr><td>platform_code</td><td>The unique identifier for the Platform onto which the customer has been created</td><td>string</td></tr><tr><td>participant_code</td><td>The NDAX identifier for the new customer<br>Note: this value is key to enable you to submit trades and check account balances for this customer</td><td>string</td></tr></tbody></table>

Possible Responses:

<table><thead><tr><th width="189">Status Code</th><th>Description</th></tr></thead><tbody><tr><td>200 OK</td><td>The customer was successfully created. Note: the request is idempotent only IF the<code>request_id</code> and payload is the <em>same</em> as previously submitted</td></tr><tr><td>400 Bad Request</td><td>The request is invalid, OR the payload is the <em>same</em> as a previously submitted request, but the <code>request_id</code> is <em>different</em>, OR, the <code>request_id</code> is the <em>same</em> as a previously submitted request, but the payload is <em>different</em></td></tr></tbody></table>