---
title: "Create Entity (Remitter/Beneficiary/Student)"
method: POST
path: "/v1/client/accounts"
---

# Create Entity (Remitter/Beneficiary/Student)

`POST /v1/client/accounts`

The Create Entity API allows the API user to create and add a new Remitter, Beneficiary(Individual/Beneficiary) or Student, for the purpose of International payments for Education.

## Headers

- `api-key` string, required
- `auth-key` string, required
- `userId` string, required

## Request body

- object
  - `accountType` string, required — The field defines the type of entity the Account would be created for. The entity could be either the remitter, the beneficiary or the student.
  - `name` string, required — Name of the remitter/student/beneficiary (As mentioned on the PAN Doc)
  - `address` string, required — Address of remitter/student/beneficiary
  - `city` string, required — City of remitter/student/beneficiary
  - `state` string, required — State of remitter/student/beneficiary
  - `country` string, required — Country of remitter/student/beneficiary (to be spelled in CAPITALS only)
  - `phone` string, required — Phone number of remitter/student/beneficiary (Please ensure the number starts with "+" followed by the countrycode and then the mobile no., as shown in the example for India)
  - `dob` string — Date of Birth (YYYY/MM/DD) of remitter/student/beneficiary, as mentioned on the PAN (Mandatory for Remitter)
  - `panNo` string — PAN number of remitter/student (Mandatory for Student/Remitter)
  - `postalCode` string, required — PIN Code/Postal Code number of remitter/student/beneficiary
  - `email` string, required — Email of remitter/student/beneficiary
  - `firstName` string — First Name of remitter/student/beneficiary
  - `middleName` string — Middle Name of remitter/student/beneficiary
  - `lastName` string — Last Name of remitter/student/beneficiary
  - `nameOnPassport` string — Full Name of STUDENT as mentioned on the Passport (Mandatory for Student)
  - `passportIssueDate` string — Date of issue of the passport for the STUDENT (Mandatory for Student) [Format: YYYY/MM/DD]
  - `passportExpiryDate` string — Date of expiry of the passport for the STUDENT (Mandatory for Student) [Format: YYYY/MM/DD]
  - `passportNo` string — ID number on the passport for the STUDENT (Mandatory for Student)
  - `reason` string — Reason for transfer.

## Response `200`

200

- object
  - `status` integer
  - `message` string
  - `data` object
    - `userAccountId` string
    - `message` string
    - `email` string

## Other responses

- `400` — 400
- `401` — 401
- `402` — 402

---

[API](https://skmtc.net/stockal/apis/uat-client-api-v2.md) · [All operations](https://skmtc.net/stockal/apis/uat-client-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockal/uat-client-api-v2/versions/08e36bbbd3be/schema)