# Create international recipient

**POST /recipients/international**

Create a recipient for international bank transfers. The data fields are specific to the transfer corridors. Please refer to the Schema section for the details.


## 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


### Query parameters
- **payoutMethod** (string)
  Payment method (e.g., LOCAL, SWIFT)
- **currencyCode** (string)
  Destination currency code
- **countryCode** (string)
  Destination country code

### Body: application/json (object)

- **alias** (string)
  Optional recipient nickname
- **data** (object)

- **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)