Create new customer

POST

https://staginggateway.fintainium.com/gateway/customer/create

The Create Customer API allows your business to add a new Accounts Receivable (AR) customer to the Fintainium platform. This customer can then be invoiced and included in payment collection workflows.
Key features:

Add a new AR customer with required details.

Include optional metadata to enrich customer profiles (e.g., customer ID, notes, preferences).

Integrates with Create Invoice and Initiate Payment for streamlined AR workflows.

Ensures accurate tracking and reconciliation of incoming payments.

Use this API to onboard new customers efficiently and prepare them for AR invoicing and payment collection.

Request

Header Params

Body Params text/plain

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://staginggateway.fintainium.com/gateway/customer/create' \
--header 'sessionKey;' \
--header 'Content-Type: text/plain' \
--data-raw '{
    "businessId": 3295462,
    "customer":[
        {
            "companyName": "Test Customer 5",
            "vendorName": "Test Customer 5",
            "taxNo": "",
            "internalId": "123456",
            "firstName": "Test",
            "lastName": "Customer",
            "emailAddress": "Test01@getnada.com",
            "phoneNumber": "",
            "phoneNumber1": "",
            "phoneNumber2": "",
            "phoneNumber3": "",
            "phoneNumber4": "",
            "isSubCustomer": false,
            "parentCustomerId": "",
            "billWithParent": false,
            "addressLine1": "1234 XYZ Street",
            "addressLine2": "",
            "addressLine3": "",
            "addressLine4": "",
            "addressLine5": "",
            "zipCode": "12234",
            "countryCode": "US",
            "stateCode": "AK",
            "cityId": 21,
            "shipAddressLine1": "",
            "shipAddressLine2": "",
            "shipAddressLine3": "",
            "shipAddressLine4": "",
            "shipAddressLine5": "",
            "shipZipCode": "",
            "shipCountryCode": "",
            "shipStateCode": "",
            "shipCityId":"",
            "isCustomer": true,
            "isSameAsBillingAddress": true
             }
        ]
    }'

Response Example

[
    {
        "id": 4440158,
        "companyName": "Test Customer 5",
        "taxNo": "",
        "firstName": "Test Customer",
        "lastName": "Test Customer",
        "emailAddress": "test01@getnada.com",
        "phoneNumber": "",
        "paymentMode": "",
        "zipCode": "12234",
        "shipZipCode": "",
        "accountNumber": "",
        "businessId": 3295462,
        "businessName": "Super Coffee Co.",
        "countryCode": "US",
        "shipCountryCode": "",
        "stateCode": "AK",
        "shipStateCode": "",
        "cityId": 21,
        "shipCityId": 0,
        "isInternational": false,
        "isCustomer": true,
        "isRegistered": false,
        "isVcEnabled": false,
        "isSyncEnabled": true,
        "status": true,
        "archive": false,
        "invitationSent": false,
        "isVisaEnabled": false,
        "isSameAsBillingAddress": false,
        "createdDate": "12/17/2024",
        "errorMsg": "",
        "businessRefId": 4440156,
        "userId": 39732,
        "creditMemoAmount": 0,
        "creditMemoLastModifiedDate": "",
        "addressLine1": "1234 XYZ Street",
        "addressLine2": "",
        "addressLine3": "",
        "addressLine4": "",
        "addressLine5": "",
        "addressLine6": "",
        "shipAddressLine1": "",
        "shipAddressLine2": "",
        "shipAddressLine3": "",
        "shipAddressLine4": "",
        "shipAddressLine5": "",
        "shipAddressLine6": "",
        "printName": "",
        "internalId": "12345906",
        "vendorName": "Test Customer 5",
        "cityName": "Waverly",
        "stateName": "Alaska",
        "shipCityName": "",
        "shipStateName": "",
        "lastModifiedDate": "12/17/2024",
        "isVendorJourney": false,
        "isNewlyAdded": true,
        "addCardDetails": false,
        "skipPasswordCreation": false,
        "isSubCustomer": false,
        "billWithParent": false,
        "parentCustomerName": "",
        "isSubCustomerExists": false,
        "wireAccountName": "Test Customer 5",
        "wireAddress": "1234 XYZ Street",
        "wireAddress2": "",
        "wireZipCode": "12234",
        "wireCountryCode": "US",
        "wireStateCode": "AK",
        "wireCityId": 21,
        "autoPayEnabled": false,
        "isExcludeRecurringInvites": false,
        "maskTaxId": false,
        "phoneNumber1": "",
        "phoneNumber2": "",
        "phoneNumber3": "",
        "phoneNumber4": ""
    }
]

Modified at 2025-09-05 17:56:34

Create new Invoice

Initiate Payment