# Create a recipient

### URI

&#x20;<mark style="color:blue;background-color:blue;">**POST**</mark>&#x20;

```
https://api.tryduplo.com/v1/recipients
```

### Parameters

#### Header

<table data-header-hidden><thead><tr><th width="249"></th><th></th></tr></thead><tbody><tr><td><strong>Authorization</strong><br><code>string</code></td><td>set value to <code>Bearer SECRET_KEY</code></td></tr></tbody></table>

#### Body Param

<table data-header-hidden><thead><tr><th width="250"></th><th></th></tr></thead><tbody><tr><td><strong>bank_code</strong><br><code>string</code> <mark style="color:red;"><code>required</code></mark></td><td>Bank code</td></tr><tr><td><strong>account_name</strong><br><code>string</code> <mark style="color:red;"><code>required</code></mark></td><td>Recipient account name</td></tr><tr><td><strong>account_number</strong><br><code>string</code> <mark style="color:red;"><code>required</code></mark></td><td>Recipient account number</td></tr><tr><td><strong>email</strong><br><code>string</code> <mark style="color:red;"><code>required</code></mark></td><td>Customer's email address</td></tr><tr><td><strong>business_id</strong><br><code>string</code>  <mark style="color:red;"><code>required</code></mark></td><td>Bussiness ID</td></tr></tbody></table>

### Sample request

{% tabs %}
{% tab title="cURL" %}
{% code overflow="wrap" %}

```bash
curl --location --request POST 'http://localhost:8080//recipients' \
--header 'Authorization: Bearer dp_live_856879df3e6ecdb14a918e24bba6d480e0564a4eabfdba938fc23b820ac905e54bac25a71dbcdef66c97b8c72ca7e16cf03a5768572615335ca5024620b14268823a7d78922cfdd97cefc61050139fd92a7a0c5840e016050552ccadbbec642d2ff8d35a09225c7ec4fd1e347b' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bank_code": "077",
    "account_name": "Jamie Fox",
    "account_number": "0666003264",
    "email": "jamefox@yopmail.com",
    "business_id": "7e7e0728-74a7-41ce-8a05-310e3e2eba4c"
}'
```

{% endcode %}
{% endtab %}

{% tab title="Node" %}
{% code overflow="wrap" lineNumbers="true" %}

```javascript
var axios = require('axios');
var data = JSON.stringify({
  "bank_code": "077",
  "account_name": "Jamie Fox",
  "account_number": "0666003264",
  "email": "jamefox@yopmail.com",
  "business_id": "7e7e0728-74a7-41ce-8a05-310e3e2eba4c"
});

var config = {
  method: 'post',
  url: 'http://localhost:8080//recipients',
  headers: { 
    'Authorization': 'Bearer dp_live_856879df3e6ecdb14a918e24bba6d480e0564a4eabfdba938fc23b820ac905e54bac25a71dbcdef66c97b8c72ca7e16cf03a571f2f16f5335ca5024620b14268823a7d78922cfdd97cefc61050139fd92a7a0c5840e016050552ccadbbec642d2ff8d35a09225c7ec4fd1e347b', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

```

{% endcode %}
{% endtab %}

{% tab title="PHP" %}
{% code overflow="wrap" lineNumbers="true" %}

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.tryduplo.com/v1/recipients',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "bank_code": "077",
    "account_name": "Jamie Fox",
    "account_number": "0666003264",
    "email": "jamefox@yopmail.com",
    "business_id": "7e7e0728-74a7-41ce-8a05-310e3e2eba4c"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer dp_live_856879df3e6ecdb14a918e6d4e0564a4eabfdba938fc23b820ac905e54bac25a71dbcdef66c97b8c72ca7e16cf03a576857261f2f16f5335ca5024620b14268823a7d78922cfdd97cefc61050139fd92a7a0c5840e016050ccadbbec642d2ff8d35a09225c7ec4fd1e347b',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

```

{% endcode %}
{% endtab %}
{% endtabs %}

### Duplo Response

```json
{
    "data": {
        "transactions": [],
        "id": "63d9a941603d9e000d163609",
        "bank_code": "50211",
        "bank_name": "Kuda Bank",
        "account_name": "Jamie Fox",
        "account_number": "1101060326",
        "email": "jamefox@yopmail.com",
        "business_id": "986acd67-b306-4642-87aa-99ba512b2601",
        "recipient_ref": "rec_svxsfsoIsqjh",
        "created_at": "2023-01-31T23:50:25.000Z",
        "updated_at": "2023-01-31T23:50:25.000Z",
    },
    "errors": {},
    "message": "Recipient was added successfully"
}
```