Create contact
Creates a contact with address and bank account. firstName and lastName are required for INDIVIDUAL contacts and optional for BUSINESS contacts, which require companyName instead. email is optional. Validates ACH routing number against the Fed directory before persistence. Returns 400 VALIDATION_ERROR if the routing number is not found.
Body
- Properties: 4Type: objectbank
Account required - Type: "BUSINESS" or "INDIVIDUAL"enumentity
Type required - Properties: 6Type: objectlegal
Address required - Type: stringFormat: uuidoriginator
Id required - Type: string | nullcompany
Name min length:1max length:100Required when entityType is BUSINESS. Rejected when entityType is INDIVIDUAL: sending a non-null companyName returns 400.
- Type: string | nullemailmax length:254Format: email
- Type: string | nullfirst
Name Required when entityType is INDIVIDUAL: null or omitted returns 400. Optional when entityType is BUSINESS, which is identified by companyName — null and omitted both mean no first name.
- Type: string | nulllast
Name Required when entityType is INDIVIDUAL: null or omitted returns 400. Optional when entityType is BUSINESS, which is identified by companyName — null and omitted both mean no last name.
- Type: string | nullphone
Number
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
curl https://staging.api.now.luqra.com/v1/contacts/ \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"bankAccount": {
"achAccountNumber": "",
"achRoutingNumber": "",
"subType": "CHECKING",
"swiftCode": null
},
"companyName": null,
"email": null,
"entityType": "BUSINESS",
"firstName": null,
"lastName": null,
"legalAddress": {
"addressLine1": "",
"addressLine2": null,
"city": "",
"countryCode": "",
"postalCode": "",
"state": ""
},
"originatorId": "",
"phoneNumber": null
}'
{
"data": {
"contactId": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2026-10-01T23:49:13.587Z"
},
"meta": {
"timestamp": "2026-10-01T23:49:13.587Z"
}
}