Create Customer

post

https://{your-totality-url}.com/api/customers

Create new customer. Permission: Create Customers

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

achProcessingPreference

string

Defaults to null

Preferred ACH processing method.

addresses

array of objects

Array of customer addresses.

addresses

birthdate

date

required

string date

canBeContactedViaPhone

boolean

Defaults to true

Whether the customer consents to phone contact.

canBeContactedViaSms

boolean

Defaults to true

Whether the customer consents to SMS messages.

canBeMarketedToViaEmail

boolean

Defaults to true

Whether the customer consents to marketing emails.

currentBankruptcyDeclaredAt

date

Defaults to null

string date/time

debitCardProcessingPreference

string

Defaults to null

Preferred debit card processing method.

string

required

The customer's email address.

ethnicity

string

Defaults to null

The customer's ethnicity.

externalId

string

Defaults to null

External system identifier for cross-referencing.

eyeColor

string

Defaults to null

The customer's eye color.

firstName

string

required

The customer's first name.

gender

string

enum

Defaults to null

The customer's gender.

Allowed:

height

string

Defaults to null

Number as string

homeOwnershipStatus

string

enum

Defaults to null

Housing status (Own, Rent, Other).

Allowed:

homePhone

string

Defaults to null

Number as string

identificationNumber

string

Defaults to null

Government ID number.

identificationState

string

Defaults to null

State that issued the government ID.

identificationType

string

enum

Defaults to null

Type of government ID (e.g., State ID, Drivers License, Passport).

Allowed:

importCompany

string

Defaults to null

Company the record was imported from.

importedOn

string

Defaults to null

Date the record was imported (YYYY-MM-DD).

importSource

string

Defaults to null

Source system the record was imported from.

incomeSources

array of objects

Array of customer income sources.

incomeSources

isEligibleForInstantFunding

boolean

Defaults to false

Whether eligible for instant funding.

isMilitary

boolean

Defaults to false

Whether the customer is active-duty military.

lastName

string

required

The customer's last name.

loans

array of strings

Loans.

loans

maritalStatus

string

enum

Defaults to null

The customer's marital status.

Allowed:

middleName

string

The customer's middle name.

mobilePhone

string

required

number as string

mothersMaidenName

string

Defaults to null

The customer's mother's maiden name.

password

string

Password settings are located at the bottom of Lender settings

paymentProcessingTime

date-time

Defaults to null

string time

preferredContactTime

string

enum

Preferred time to contact (e.g., Anytime, Morning, Afternoon, Evening).

Allowed:

preferredPhone

string

enum

Preferred phone for contact (Home, Mobile, Work).

Allowed:

previousBankruptcyDeclaredAt

date

Defaults to null

string date/time

previousBankruptcyDismissedAt

date

Defaults to null

string date/time

purchasedOn

date

Defaults to null

string date

race

string

Defaults to null

The customer's race.

rccProcessingPreference

string

Defaults to null

Preferred RCC processing method.

revokedPaymentTypes

array

Payment types revoked for this customer.

revokedPaymentTypes

socialSecurityNumber

string

required

number as string

spouseEmail

string

Defaults to null

Email of the customer's spouse.

spouseName

string

Defaults to null

Name of the customer's spouse.

suffix

string

enum

Defaults to null

Name suffix (e.g., Jr, Sr, I, II, III).

username

string

Username the customer can use to login to their portal

weight

int32

Defaults to null

The customer's weight.

Headers

string

required

Defaults to application/vnd.totality.v1+json

Must be application/json.

Content-Type

string

required

Defaults to application/json

Must be application/json.

Responses

200Successful response

401401

422422

500500