Download Postman Collection
2026

Sections

Theme switcher

Create/Edit Bene

Header Parameters

Content-Typestring Required

application/json

CMG-AccessTokenstring Required

{insert Client-level "access_code"}

Path Parameters

clientCodestring Required

A unique 6-digit client identifier for each client account

clientIntegrationIdstring Required

Unique beneficiary ID that can be used in other endpoints.

Body Parameters

accountHolderNamestring Required

Full name of the account holder.

Max length
100
templateIdentifierstring Required

The client-assigned template identifier. This value should match the clientIntegrationId in the URL. The value in this field is returned in the beneIdentifier field when you run GET View Bene.

Max length
50
destinationCountrystring Required

Two-letter ISO code for the country where the beneficiary's bank is located.

bankCurrencystring Required

ISO-4217 Currency Code for the bank account.

classificationstring Required

Beneficiary classification = Individual or Business. Most of the other values shown in GET Beneficiary Rules.

paymentMethodsarray Required

Methods of payment that can be used for this beneficiary = [W or E] W = Wire E = EFT

preferredMethodstring Required

Method of payment preferred by this beneficiary.

accountNumberstring Required

Bank account number

localAccountNumberstring

Bank account number

routingCodestring Required

Bank routing code - used to identify a specific financial institution. In some countries, the routing code is known by another name, such as ABA Number, Transit Number, Sort Code, BSB Number, IFSC Code, or Branch Code. Required for Wires

localRoutingCodestring

Bank routing code

accountHolderCountrystring Required

The account holder's two-letter ISO country code.

accountHolderRegionstring Required

The account holder's province or state. Value can be either id or code returned by GET Regions. Required for Canada, Mexico, and the United States.

Max length
30
accountHolderAddress1string Required

First line of the account holder's address. PO Box addresses are not allowed for Australia, Canada, and Mexico

Max length
50
accountHolderAddress2string

Second line of the account holder's address. PO Box addresses not allowed for Australia, Canada, and Mexico .

Max length
50
accountHolderCitystring Required

The account holder's city.

Max length
100
accountHolderPostalstring Required

The account holder's postal or zip code. Required for Canada, Mexico, and the United States

Max length
50
accountHolderPhoneNumberinteger Required

The account holder's phone number. Required if mandatory for destination country.

accountHolderEmailstring Required

Email address. Required if SendPayTracker = true

sendPayTrackerboolean

Specifies whether to send an email alert to the beneficiary whenever a payment is released = [true, false].

swiftBicCodestring Required

The unique identifier for the bank or financial institution. Required for Wires

bankNamestring Required

Name of the financial institution.

Max length
250
bankCountrystring Required

The bank's two-letter ISO country code.

bankRegionstring Required

The bank's province or state. Note: Value can be either id or code returned by GET Regions. Required for Canada, Mexico, and the United States.

Max length
100
bankCitystring Required

The bank's city.

Max length
100
bankAddressLine1string Required

First line of the bank's address.

Max length
100
bankAddressLine2string

Second line of the bank's address.

Max length
100
bankPostalstring Required

The bank's postal or zip code. Required for Canada, Mexico, and the United States

Max length
50
paymentReferencestring

Default payment reference that will be used if a reference is not provided on a payment. The payment reference is transmitted with the payment, subject to banking constraints.

internalPaymentAlertstring

Internal email addresses to notify when a payment is made to this beneficiary.

externalPaymentAlertstring

External email addresses to notify when a payment is made to this beneficiary.

furtherCreditDetailsstring

Enter the details of the recipient who will receive the funds. Must start with FFC followed by name and account number. Do not enter special characters.

Max length
50
Pattern
FFC Tom Roe 000304756
regulatoryarray

The fields and corresponding values needed to satisfy regulatory requirements for the destination country. Required if mandatory for the destination country. Use GET Beneficiary Rules endpoint to retrieve valid values.

Show child attributes

Was this section helpful?

What made this section unhelpful for you?

POST

/

Select
1

Response

Error Codes

400 Bad Request - Value provided doesn't match the RegEx

The value in the specified field does not contain the required number of characters or contains characters that are not allowed.

400 Bad Request - Field is mandatory

One or more required field values are missing.

400 Bad Request - Value provided is not in the set of valid values

The value provided is not an allowed value for the specified field.

400 Bad Request - Beneficiary Identifier has already been assigned

The templateIdentifier already exists and cannot be used again.

Was this section helpful?

What made this section unhelpful for you?