Create contact
Creates a contact with a bank account and an optional legal address. firstName and lastName are required for INDIVIDUAL contacts and optional for BUSINESS contacts, which require companyName instead. email and legalAddress are optional; when an address is sent, all of its fields except addressLine2 are required together. 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 - 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: object | nulllegal
Address Properties: 6Optional. Null and omitted both mean no legal address.
- Type: string | nullphone
Number
Responses
- application/json
- 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": "123e4567-e89b-12d3-a456-426614174000",
"phoneNumber": null
}'
{
"data": {
"contactId": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2026-11-12T18:04:42.401Z"
},
"meta": {
"timestamp": "2026-11-12T18:04:42.401Z"
}
}