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

required
application/json
  • Properties: 4
  • 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.

  • Optional. Null and omitted both mean no legal address.

    Properties: 6

Responses

  • application/json
  • 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": "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"
  }
}