Sokin Embeded API
  1. v2025-12-01
Sokin Embeded API
  • Getting Started
    • Sokin Definitions
    • Guides
      • Authentication
      • Receiving Payments
      • FX Payments
      • Payments
      • Unfunded Payments
      • Unfunded FX Payments
  • Authentication
    • Get Token
      POST
    • Get Token on behalf of corporate
      POST
    • Schemas
      • TokenResponse
  • Corporate Currency Accounts
    • v2025-12-01
      • Get Corporate Currency Accounts
      • Get Corporate Currency Account By Reference
    • Schemas
      • GetCCAByReferenceResponse
      • GetCCAsResponse
      • GetCCAsResponseItem
      • GetCCAByReferenceResponsePayInDetail
      • PaginationInfo
  • Beneficiaries
    • v2025-12-01
      • Get Beneficiary Fields
        GET
      • Create External Beneficiary
        POST
      • Get Beneficiary List
        GET
      • Get Beneficiary Details
        GET
      • Delete Beneficiary
        DELETE
    • Schemas
      • BeneficiaryDetailsResponse
      • CreateExternalBeneficiaryRequest
      • CreateExternalBeneficiaryResponse
      • GetBeneficiaryFieldsResponse
      • BeneficiaryListResponse
      • BeneficiaryListResponse
  • Instruction Requests
    • v2025-12-01
      • Get Instruction Request By Reference
      • Create Payment Instruction Request
      • Create Fx Instruction Request
      • Create Fx Payment Instruction Request
      • Create Unfunded Payment Instruction Request
      • Create Unfunded Fx Payment Instruction Request
    • Schemas
      • CreateFXInstructionRequest
      • CreateFxPaymentInstructionRequest
      • CreateInstructionRequestResponse
      • CreatePaymentInstructionRequest
      • CreateResellerFxPaymentInstructionRequest
      • CreateResellerPaymentInstructionRequest
      • GetInstructionRequestResponse
  • Instructions
    • v2025-12-01
      • Get Instruction By Reference
    • Schemas
      • GetInstructionResponse
  • Foreign Exchange
    • v2025-12-01
      • Get Fx Rate
    • Schemas
      • FxRateRequest
  • Webhooks
    • Webhooks
    • Schemas
      • InstructionCreated
      • InstructionReqeustRejected
      • InstructionProcessedWebhook
      • InstructionRejectedWebhook
      • OnboardingRequestApproved
      • OnboardingRequestRejected
      • CorporateActivated
      • CorporateDeactivated
      • CorporateCurrencyAccountFundingReceived
  1. v2025-12-01

Create External Beneficiary

Testing Env
https://api.uat.sokin.com
Testing Env
https://api.uat.sokin.com
POST
/beneficiaries/external_beneficiary
Create an external beneficiary.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created
application/json
Successful Response
Body

🟠422Unprocessable Entity
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.uat.sokin.com/beneficiaries/external_beneficiary' \
--header 'x-api-version;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "currency": "str",
    "country": "st",
    "type": {},
    "transaction_type": "string",
    "beneficiary_country": "string",
    "routing_number": "string",
    "beneficiary_name": "string",
    "financial_institution": "string",
    "financial_institution_branch": "string",
    "email": "string",
    "mobile_number": "strings",
    "account_name": "string",
    "account_type": {},
    "account_number": "string",
    "identifier_type": {},
    "identifier_value": "string",
    "house_building_number": "string",
    "street_name": "string",
    "postal_code": "string",
    "city": "string",
    "state_or_province": "string",
    "bank_id": "string",
    "account_first_name": "string",
    "account_last_name": "string",
    "address_line_1": "string",
    "address_line_2": "string",
    "address_line_3": "string",
    "iban": "string"
}'
Response Response Example
201 - Example 1
{
    "status": 202,
    "success": true,
    "message": "string",
    "beneficiary_id": "e1be8a3d-c052-4912-b287-2412e915ecf9",
    "validation_errors": []
}
Modified at 2025-12-05 12:22:35
Previous
Get Beneficiary Fields
Next
Get Beneficiary List
Built with