# Create New Receiver

Create a new receiver under a SubAccount for receiving the payout.

## Create a New Receiver

<mark style="color:orange;">`POST`</mark> `/api/receiver`

**Headers**

| Name        | Value     |
| ----------- | --------- |
| `x-api-key` | `<token>` |
| `signature` | `<token>` |

**Body**

| Name                                           | Type   | Description                             |
| ---------------------------------------------- | ------ | --------------------------------------- |
| `fisrt_name`<mark style="color:red;">\*</mark> | string | First Name of the receiver user.        |
| `last_name`<mark style="color:red;">\*</mark>  | string | Last Name of the receiver the user.     |
| `email`<mark style="color:red;">\*</mark>      | string | Email of the receiver the user.         |
| `middle_name`                                  | string | Middle Name of the receiver the user.   |
| `dob`<mark style="color:red;">\*</mark>        | string | Date of Birth of the receiver the user. |
| `dialcode`<mark style="color:red;">\*</mark>   | string | Dial Code of the receiver the user.     |
| `phone`<mark style="color:red;">\*</mark>      | string | Phone of the receiver the user.         |
| `address`<mark style="color:red;">\*</mark>    | string | Address of the receiver the user.       |
| `address2`<mark style="color:red;">\*</mark>   | string | Address2 of the receiver the user.      |
| `gender`<mark style="color:red;">\*</mark>     | string | Gender of the receiver the user.        |
| `city`<mark style="color:red;">\*</mark>       | string | City of the receiver the user.          |
| `state`<mark style="color:red;">\*</mark>      | string | State of the receiver the user.         |
| `postcode`<mark style="color:red;">\*</mark>   | string | Postcode of the receiver the user.      |
| `country`<mark style="color:red;">\*</mark>    | string | Country of the receiver the user.       |
| `reference`                                    | string | Reference of the receiver.              |

&#x20;<mark style="color:red;">\*</mark> is mandatory parameter

#### Example body request

```json
{
    "first_name": "David",
    "last_name": "Lahm",
    "middle_name": "Robert",
    "email":"davidrlahm84@gmail.com",
    "dob": "1990-03-21",
    "dialcode": "61",
    "phone": "213094857",
    "address": "122",
    "address2": "Peel Street",
    "gender": "M",
    "city": "North Melbourne",
    "state": "VIC",
    "postcode": "3051",
    "country": "AUS",
    "reference": "david8740"
}
```

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "message": "Receiver created successfully",
    "payload": {
        "receiver_id": "d81b714c-a082-431a-8935-d0c67ad22c2d",
        "kyc_status": "0"
    }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "message": "There was an error while creating a receiver",
    "error": [
        {
            "code": "REVR201",
            "message": "Email already exist"
        }
    ]
}
```

{% endtab %}
{% endtabs %}