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

required
application/json
  • Properties: 4
  • Properties: 6
  • Required when entityType is BUSINESS. Rejected when entityType is INDIVIDUAL: sending a non-null companyName returns 400.

  • 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.

  • 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.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/v1/contacts/
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"
  }
}