Skip to main content
POST
/
v0
/
users
/
create
Create a new User account
curl --request POST \
  --url https://api.fungies.io/v0/users/create \
  --header 'Content-Type: application/json' \
  --header 'x-fngs-public-key: <api-key>' \
  --header 'x-fngs-secret-key: <api-key>' \
  --data '
{
  "email": "[email protected]",
  "password": "<string>",
  "username": "<string>",
  "internalId": "<string>",
  "billingDetails": {
    "type": "individual",
    "countryCode": "AF",
    "firstName": "<string>",
    "lastName": "<string>",
    "dialCode": "<string>",
    "phoneNumber": "<string>",
    "address": "<string>",
    "addressLine2": "<string>",
    "city": "<string>",
    "postalCode": "<string>",
    "state": "<string>",
    "taxId": "al_tin_albania",
    "taxNumber": "<string>"
  },
  "paymentData": {
    "stripeCustomerId": "<string>",
    "paypalCustomerId": "<string>"
  }
}
'
{
  "status": "<string>",
  "data": {
    "user": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "object": "user",
      "username": null,
      "email": null,
      "details": null,
      "internalId": null
    }
  }
}

Authorizations

​
x-fngs-public-key
string
header
required
​
x-fngs-secret-key
string
header
required

Body

application/json

POST /v0/users/create Request body

​
email
string<email>
required

Email of the user.

​
password
string | null

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.

Required string length: 8 - 72
​
username
string | null

Username of the User.

Minimum string length: 1
​
internalId
string | null

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

Minimum string length: 1
​
billingDetails
object

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)

All other fields are optional but recommended for a complete billing profile.
​
paymentData
object

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

POST /v0/users/create Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required