# Create Member

## 3.1 Create Member

Creates a new member for the given merchant.

**Request**

| Method | URL                    |
| ------ | ---------------------- |
| POST   | /onboarding/v1/members |

```
{
  "isBuyer": true,
  "isSubMerchant": false,
  "memberType": "PERSONAL",
  "memberExternalId": "external123",
  "name": "John Doe",
  "address": "123 Main St, City",
  "email": "john.doe@example.com",
  "iban": "TR123456789012345678901234",
  "phoneNumber": "1234567890",
  "legalCompanyTitle": "Doe Enterprises",
  "taxOffice": "City Tax Office",
  "taxNumber": "1234567890",
  "contactName": "John",
  "contactSurname": "Doe",
  "identityNumber": "12345678901",
  "subMerchantMaximumAllowedNegativeBalance": 100.0
}
```

**Response**

| Status | Response                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200    | <p>{</p><p>"data": {</p><p>"id": 1,</p><p>"createdDate": "2022-01-01T12:00:00",</p><p>"updatedDate": "2022-01-01T12:00:00",</p><p>"status": "Active",</p><p>"isBuyer": true,</p><p>"isSubMerchant": false,</p><p>"memberType": "Individual",</p><p>"memberExternalId": "external123",</p><p>"name": "John Doe",</p><p>"address": "123 Main St, City",</p><p>"email": "<john.doe@example.com>",</p><p>"phoneNumber": "1234567890",</p><p>"identityNumber": "12345678901",</p><p>"contactName": "John",</p><p>"contactSurname": "Doe",</p><p>"legalCompanyTitle": "Doe Enterprises",</p><p>"taxOffice": "City Tax Office",</p><p>"taxNumber": "1234567890",</p><p>"settlementEarningsDestination": "",</p><p>"iban": "TR123456789012345678901234",</p><p>"subMerchantMaximumAllowedNegativeBalance": 100.0</p><p>}</p><p>}</p> |
| 403    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 400    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 401    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 401    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 500    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

[<br>](https://hilals-organization.gitbook.io/magicpay-documentation/3.-members)