# Add AU Bank Account

Create a new receiver account for receiver

## Create a New Receiver Account

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

**Headers**

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

**Body**

| Name                                               | Type   | Description                                                                       |
| -------------------------------------------------- | ------ | --------------------------------------------------------------------------------- |
| `receiver_id`<mark style="color:red;">\*</mark>    | string | Receiver ID of receiver account.                                                  |
| `account_type`<mark style="color:red;">\*</mark>   | string | Account Type of receiver account. **'I' is 'Individual'** and **'B' is Business** |
| `bsb`<mark style="color:red;">\*</mark>            | string | BSB of receiver account.                                                          |
| `account_number`<mark style="color:red;">\*</mark> | string | Account number of receiver account.                                               |
| `aka`                                              | string | Alias name of receiver account.                                                   |
| `occupation`                                       | string | Occupation of receiver account holder.                                            |
| `homedialcode`                                     | string | Home Dialcode of receiver account holder.                                         |
| `homephone`                                        | string | Homephone of receiver account holder.                                             |
| `abn`                                              | string | ABN of receiver account.                                                          |
| `acn`                                              | string | ACN of receiver account.                                                          |
| `nzbn`                                             | string | NZBN of receiver account.                                                         |

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

#### Example body request

```json
{
    "receiver_id": "a2bb66db-7067-44a2-8067-1393b682bc75",
    "account_type": "I", // For 'Individual'
    "bsb": "012002",
    "account_number": "111136"
}
```

**Response**

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

```json
{
    "message": "Receiver account created successfully",
    "payload": {
        "account_id": "ad5ac900-ac63-4e60-894b-1de10f04f876"
    }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "message": "There was an error while creating a receiver account",
    "error": [
        {
            "code": "REAC211",
            "message": "Receiver ID is not valid"
        }
    ]
}
```

{% endtab %}
{% endtabs %}