Update customer

Update an existing customer information

SecurityoAuth2
Request
path Parameters
customerUID
required
string

Customer unique identifier associated with the customer in the Finzly's CRM system

Request Body schema: application/json
required

Customer details

externalReferenceId
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
string

Customer's legal name

customerId
string

Customer Id assigned by the user.

customerType
string

Type of customer

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

Tax ID / TIN/SSN

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

object (UpdateCustomerAddress)
mailAddressSameAsLegal
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
string

Cost Center code

relationshipManager
string

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

originatingOfficer
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

note
string
object (LegalEntityAccessSettings)
Array of objects (CustomerAppLimit)
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

put/v2/customers/{customerUID}
Request samples
application/json
{
  • "externalReferenceId": "REQ1231",
  • "legalName": "ABC Bank",
  • "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 or Bank or ThirdParty or Self",
  • "partnerOrgShortName": "ABC",
  • "costCenter": "123123121",
  • "relationshipManager": "testuser",
  • "originatingOfficer": "testuser",
  • "parentEntityShortName": "ParentEntity",
  • "additionalProfileDetails": {
    },
  • "secCodes": [
    ],
  • "note": "string",
  • "legalEntityAccessSettings": {
    },
  • "limits": [
    ]
}
Response samples
application/json
{
  • "status": "Success",
  • "code": "CUST001",
  • "message": "Failed to get the customer: <Reason>",
  • "data": [
    ]
}