Create a new User account

Creates a new User account in the system. The email must be unique across all Users. Returns the created User object with all fields except the password. Note: If billingDetails are provided, ensure the countryCode is valid and postalCode is included for required countries.

Authorization

Public key Secret key

x-fngs-public-key<token>

In: header

x-fngs-secret-key<token>

In: header

Request Body

application/json

POST /v0/users/create Request body

TypeScript Definitions

Use the request body type in TypeScript.

email*string

Email of the user.

Formatemail

password?|

User password used for logging in to the Store application. Password must contain at least one special character, one number and one uppercase letter. Password must be between 8 and 72 characters long.

Match[!"#$%&'()*+,-./:;<=>?@[\\\]^_`{|}~0-9]

Length8 <= length <= 72

username?|

Username of the User.

Length1 <= length

internalId?|

A custom identifier for external system integration. This ID: - Can be used to link users with external systems - Will be included in all webhook notifications - Is optional but recommended for system integration

Length1 <= length

billingDetails?

Billing information used for payments and invoices. Following fields are required for the payments: - countryCode: ISO 3166-1 alpha-2 country code (e.g., "US", "GB") - postalCode: Required for specific countries (US, CA, UA, IN)

For company accounts, set type to "company" and provide companyName, taxId and taxNumber.These fields will appear on generated invoices.All other fields are optional but recommended for a complete billing profile.

paymentData?

Pre-existing payment provider (Stripe/Paypal) customer IDs. Only provide this if: - You're migrating users from another system - You want to link existing Stripe/PayPal customers - You need to preserve payment history in provider's system

This is typically handled automatically during the first payment.

Response Body

`application/json`

curl -X POST "https://example.com/v0/users/create" \  -H "Content-Type: application/json" \  -d '{    "email": "test@example.com"  }'

{  "status": "success",  "data": {    "user": {      "object": "user",      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "username": null,      "email": null,      "details": null,      "internalId": null    }  }}

Create a new User account

Authorization

Request Body

Response Body

200application/json

400application/json

`application/json`

`application/json`