# Create internal recipient

**POST /recipients/internal**

Create a recipient for local/internal bank transfers


## Servers
- Sandbox - Banking Operations: https://bank.bank.place (Sandbox - Banking Operations)
- Sandbox - Authentication: https://auth.bank.place (Sandbox - Authentication)


## Authentication methods
- Bearer auth


## Parameters
### Headers
- **Workspace-ID** (integer)
  The workspace ID - to identify the sub-user



### Body: application/json (object)

- **accountCode** (string)
  Recipient account code/number
- **alias** (string)
  Optional recipient nickname
- **saved** (boolean)
  Save recipient for future use


## Responses
### 201
Recipient created successfully

#### Body: application/json (object)
- **accountCode** (string)
  Recipient account code
- **alias** (string)
  Recipient nickname
- **createdAt** (string)
  Creation timestamp
- **edges** (object)

- **id** (integer)
  Recipient ID
- **name** (string)
  Recipient name
- **saved** (boolean)
  Whether recipient is saved
- **updatedAt** (string)
  Last update timestamp

### 400
Invalid request

#### Body: application/json (object)
- **errorCode** (string)
  Error code
- **message** (string)
  Error message

### 401
Unauthorized

#### Body: application/json (object)
- **errorCode** (string)
  Error code
- **message** (string)
  Error message

### 409
Recipient already exists


[Powered by Bump.sh](https://bump.sh)