Create Your First Customer

Customer creation is basics-only. The first request registers the company with a small set of core fields and returns a DRAFT customer. Everything else — the full KYB questionnaire, associates, and documents — is collected and verified by our verification partner AiPrise during onboarding, not through the Partner REST API. You need CUSTOMERS_WRITE to create a customer. Add CUSTOMERS_READ if your integration reads the customer back after creation.

Prepare the create payload

Only companyName is required. Country IDs are alpha-2 codes that must be accepted by Nuvera; the Partner REST API does not expose a country lookup endpoint.

{
  "companyName": "Acme Imports GmbH",
  "registrationNumber": "ACME-123",
  "countryOfIncorporationId": "<country-alpha-2>"
}

Create the customer

Generate the signed JWT with method set to POST, uri set to /api/v1/customers, and bodyHash set to the SHA-256 hash of the exact JSON bytes sent as BODY.

BODY='{"companyName":"Acme Imports GmbH","registrationNumber":"ACME-123","countryOfIncorporationId":"<country-alpha-2>"}'
TOKEN="<signed-request-jwt>"

curl https://rest-api.nuvera.global/api/v1/customers \
  -H "x-api-key: $NUVERA_API_KEY" \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  --data "$BODY"

The response is the customer’s basic details and status, which starts as DRAFT.

Optional fields

These fields are optional. Add them when they help your workflow; AiPrise collects and may overwrite the remaining company profile during onboarding.

Field	Required?	Use
`registrationNumber`	Optional	Company registration number.
`countryOfIncorporationId`	Optional	Country of incorporation (alpha-2).
`addressLine1`	Optional	Registered address line 1.
`addressLine2`	Optional	Registered address line 2.
`city`	Optional	Registered address city.
`stateProvinceRegion`	Optional	Registered address state/province.
`postalCode`	Optional	Registered address postal code.
`addressCountryId`	Optional	Registered address country (alpha-2).

What happens after creation

A new customer is DRAFT. Verification is completed through AiPrise:

The customer opens their verification session and submits the full KYB details and documents to AiPrise.
AiPrise and Nuvera compliance review the submission; the customer moves to PENDING_REVIEW, then APPROVED, CORRECTION_REQUESTED, REJECTED, or SUSPENDED.
Track the customer with GET /api/v1/customers/{id} and GET /api/v1/customers/{id}/activity. When corrections are requested, see Handle Corrections.

For the complete customer schema, open the API Reference.

Getting Started

Partner API

Core Workflows

Operations

Create Your First Customer

Optional fields

What happens after creation

​Optional fields

​What happens after creation

Optional fields

What happens after creation