Create a business customer

Create a business customer record. See customer object definition for parameter details. The parameters you are required to pass to Helix can vary depending on your program settings.

🚧Warning

Use of this endpoint requires approval from Q2 and your bank of record.

Error Codes

Click to expand
CodeMessage (en-US)Notes
1-60000Any "Common Error Code" may occur.See Common Error Codes
60006businessNameOnCard 0 is restricted to 26 characters.
60007businessNameOnCard 0 contains invalid characters. Refer to API documentation for valid characters.
60261Invalid taxIdType '0'. Refer to API documentation for valid types.
60262BusinessLegalName is a required field
60268LegalEntityType is a required field
60269Invalid legalEntityType '0'. Refer to API documentation for valid types.
60270A business with same businessLegalName '0' and legalEntityType '1' and doingBusinessAs '2' and taxId '3' already exist
60272PrimaryBusiness address type is required
60273Registered address type is required
60274FormationState must not be longer than 2 characters
60275TaxIdType is a required field
60350Only five addresses are allowed -- one for each valid type. Refer to API documentation for valid types.
60351Only three phones are allowed -- one for each valid type. Refer to API documentation for valid types.
61400Program is not authorized to use this endpoint. Please contact your relationship manager for details.
66901Invalid Address Type '0'. Refer to API documentation for valid types.
Body Params
string
required
string
enum
required
string
required
length ≤ 30

No formatting (no dashes, spaces, etc).

string
enum
required
Allowed:
string
string
length ≤ 200
date-time
string
length ≤ 2
int32
≥ 1
boolean
boolean
string
enum

Accepted values vary by program:

  • en-US: English
  • es-US: Spanish
Allowed:
boolean
boolean
string
length ≤ 26
string
string
length ≤ 50
string
length ≤ 255
string
length ≤ 100
string
length ≤ 100
string
length ≤ 100
string
length ≤ 100
string
length ≤ 100
addresses
array of objects
addresses
phones
array of objects
phones
Responses

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json