Add customer

Create a customer in the BankOS CRM system

SecurityoAuth2
Request
Request Body schema: application/json
required

Customer details

externalReferenceId
required
string

Unique reference id from a system outside of finzly. The external reference id can be used by the finzly for the request tracing (if needed).

legalName
required
string

Customer's legal name

shortName
required
string

Customer's short name

customerId
string

Customer Id, this is an optional field and if it is provided then it is unique.

customerType
required
string

Type of customer

Enum: "Corporate" "Consumer" "Financial Institution" "Downstream Partner" "Processing Org"
taxId
required
string

Tax ID

achCompanyID
string

ACH company ID is a 10-digit identifier used by banks and Nacha, the operator of the ACH network, to identify the entity collecting payments or sending money via ACH (also referred to as an “originator”)

lei
string

Legal Entity ID for accounting/tax purpose

swiftCode
string

SWIFT code

language
required
string

Suported language

emailAddress
string

Customer Email Address

phoneNumber
string

Customer's Phone number

faxNumber
string

Customer's phone number

webSite
string

Customer's website

logoUrl
string

Customer's logo url

linkedinUrl
string

Customer's LinkedIn profile URL

twitterUrl
string

Customer's twitter url

required
object (CustomerAddress)
mailAddressSameAsLegal
required
boolean
object (UpdateCustomerAddress)
relationshipType
string

Relationship Type

Enum: "customer" "bank" "thirdparty" "self"
partnerOrgShortName
string

This is shortname of the partner org. This is required if the relationshipType is Third Party optional otherwise.

costCenter
required
string

Cost Center code

relationshipManager
required
string

Relationship manager name. It needs to be a valid user login id in the system

originatingOfficer
required
string

Originating Officer name. Its needs to be a valid user login id in the system

parentEntityShortName
string

This is shortname of the parent org

object (CustomerAdditonalProfileDetails)
secCodes
Array of strings

Provide all valid SEC-Standard Entry Class codes allowed for the given customer entity. e.g. WEB,CCD,PPD,TEL,IAT, etc..

note
string

notes

object (LegalEntityAccessSettings)
Responses
200

Successfully processed request

400

bad input parameter environment

401

You are not authorized to access the resource

402

The parameters were valid but the request failed.

403

Accessing the resource you were trying to reach is forbidden

404

The resource you were trying to reach is not found

405

bad input parameter environment

409

The request conflicts with another request (perhaps due to using the same idempotent key).

429

Too many requests hit the API too quickly. We recommend an exponential backoff of your requests.

500

Something went wrong on back end.

503

Service unavailable

default

Customer details with newly created ID

post/v2/customers
Request samples
application/json
{
  • "externalReferenceId": "REQ123",
  • "legalName": "ABC Bank",
  • "shortName": "BOFA",
  • "customerId": "CUST123",
  • "customerType": "Corporate",
  • "taxId": "123456789",
  • "achCompanyID": "1234567899",
  • "lei": "ABC1234",
  • "swiftCode": "BOFAUS3N",
  • "language": "English",
  • "emailAddress": "abc@abc.com",
  • "phoneNumber": "123-124-9877",
  • "faxNumber": "123-124-9877",
  • "webSite": "http://www.finzly.com",
  • "logoUrl": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_92x30dp.png",
  • "linkedinUrl": "https://www.linkedin.com/company/finzly",
  • "twitterUrl": "https://twitter.com/finzly",
  • "legalAddress": {
    },
  • "mailAddressSameAsLegal": true,
  • "mailingAddress": {
    },
  • "relationshipType": "Customer",
  • "partnerOrgShortName": "ABC",
  • "costCenter": "123123121",
  • "relationshipManager": "testuser",
  • "originatingOfficer": "testuser",
  • "parentEntityShortName": "ParentEntity",
  • "additionalProfileDetails": {
    },
  • "secCodes": [
    ],
  • "note": "Note for the LE",
  • "legalEntityAccessSettings": {
    }
}
Response samples
application/json
{
  • "status": "Success",
  • "code": "CUST001",
  • "message": "Failed to create a customer due to the mandatory attribute <attribute-name> is not provide.",
  • "data": {
    }
}