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": "jsmith@example.com",
"password": "<string>",
"username": "<string>",
"internalId": "<string>",
"billingDetails": {
"firstName": "<string>",
"lastName": "<string>",
"companyName": "<string>",
"dialCode": "<string>",
"phoneNumber": "<string>",
"address": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"postalCode": "<string>",
"state": "<string>",
"taxNumber": "<string>"
},
"paymentData": {
"stripeCustomerId": "<string>",
"paypalCustomerId": "<string>"
}
}
'import requests
url = "https://api.fungies.io/v0/users/create"
payload = {
"email": "jsmith@example.com",
"password": "<string>",
"username": "<string>",
"internalId": "<string>",
"billingDetails": {
"firstName": "<string>",
"lastName": "<string>",
"companyName": "<string>",
"dialCode": "<string>",
"phoneNumber": "<string>",
"address": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"postalCode": "<string>",
"state": "<string>",
"taxNumber": "<string>"
},
"paymentData": {
"stripeCustomerId": "<string>",
"paypalCustomerId": "<string>"
}
}
headers = {
"x-fngs-public-key": "<api-key>",
"x-fngs-secret-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-fngs-public-key': '<api-key>',
'x-fngs-secret-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: 'jsmith@example.com',
password: '<string>',
username: '<string>',
internalId: '<string>',
billingDetails: {
firstName: '<string>',
lastName: '<string>',
companyName: '<string>',
dialCode: '<string>',
phoneNumber: '<string>',
address: '<string>',
addressLine2: '<string>',
city: '<string>',
postalCode: '<string>',
state: '<string>',
taxNumber: '<string>'
},
paymentData: {stripeCustomerId: '<string>', paypalCustomerId: '<string>'}
})
};
fetch('https://api.fungies.io/v0/users/create', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fungies.io/v0/users/create",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'email' => 'jsmith@example.com',
'password' => '<string>',
'username' => '<string>',
'internalId' => '<string>',
'billingDetails' => [
'firstName' => '<string>',
'lastName' => '<string>',
'companyName' => '<string>',
'dialCode' => '<string>',
'phoneNumber' => '<string>',
'address' => '<string>',
'addressLine2' => '<string>',
'city' => '<string>',
'postalCode' => '<string>',
'state' => '<string>',
'taxNumber' => '<string>'
],
'paymentData' => [
'stripeCustomerId' => '<string>',
'paypalCustomerId' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-fngs-public-key: <api-key>",
"x-fngs-secret-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fungies.io/v0/users/create"
payload := strings.NewReader("{\n \"email\": \"jsmith@example.com\",\n \"password\": \"<string>\",\n \"username\": \"<string>\",\n \"internalId\": \"<string>\",\n \"billingDetails\": {\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"companyName\": \"<string>\",\n \"dialCode\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"address\": \"<string>\",\n \"addressLine2\": \"<string>\",\n \"city\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"state\": \"<string>\",\n \"taxNumber\": \"<string>\"\n },\n \"paymentData\": {\n \"stripeCustomerId\": \"<string>\",\n \"paypalCustomerId\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-fngs-public-key", "<api-key>")
req.Header.Add("x-fngs-secret-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fungies.io/v0/users/create")
.header("x-fngs-public-key", "<api-key>")
.header("x-fngs-secret-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"jsmith@example.com\",\n \"password\": \"<string>\",\n \"username\": \"<string>\",\n \"internalId\": \"<string>\",\n \"billingDetails\": {\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"companyName\": \"<string>\",\n \"dialCode\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"address\": \"<string>\",\n \"addressLine2\": \"<string>\",\n \"city\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"state\": \"<string>\",\n \"taxNumber\": \"<string>\"\n },\n \"paymentData\": {\n \"stripeCustomerId\": \"<string>\",\n \"paypalCustomerId\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fungies.io/v0/users/create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-fngs-public-key"] = '<api-key>'
request["x-fngs-secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"jsmith@example.com\",\n \"password\": \"<string>\",\n \"username\": \"<string>\",\n \"internalId\": \"<string>\",\n \"billingDetails\": {\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"companyName\": \"<string>\",\n \"dialCode\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"address\": \"<string>\",\n \"addressLine2\": \"<string>\",\n \"city\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"state\": \"<string>\",\n \"taxNumber\": \"<string>\"\n },\n \"paymentData\": {\n \"stripeCustomerId\": \"<string>\",\n \"paypalCustomerId\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"status": "<string>",
"data": {
"user": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"object": "user",
"username": null,
"email": null,
"details": null,
"internalId": null
}
}
}{
"status": "error",
"error": {
"message": "Sample error message"
}
}users
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.
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": "jsmith@example.com",
"password": "<string>",
"username": "<string>",
"internalId": "<string>",
"billingDetails": {
"firstName": "<string>",
"lastName": "<string>",
"companyName": "<string>",
"dialCode": "<string>",
"phoneNumber": "<string>",
"address": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"postalCode": "<string>",
"state": "<string>",
"taxNumber": "<string>"
},
"paymentData": {
"stripeCustomerId": "<string>",
"paypalCustomerId": "<string>"
}
}
'import requests
url = "https://api.fungies.io/v0/users/create"
payload = {
"email": "jsmith@example.com",
"password": "<string>",
"username": "<string>",
"internalId": "<string>",
"billingDetails": {
"firstName": "<string>",
"lastName": "<string>",
"companyName": "<string>",
"dialCode": "<string>",
"phoneNumber": "<string>",
"address": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"postalCode": "<string>",
"state": "<string>",
"taxNumber": "<string>"
},
"paymentData": {
"stripeCustomerId": "<string>",
"paypalCustomerId": "<string>"
}
}
headers = {
"x-fngs-public-key": "<api-key>",
"x-fngs-secret-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-fngs-public-key': '<api-key>',
'x-fngs-secret-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: 'jsmith@example.com',
password: '<string>',
username: '<string>',
internalId: '<string>',
billingDetails: {
firstName: '<string>',
lastName: '<string>',
companyName: '<string>',
dialCode: '<string>',
phoneNumber: '<string>',
address: '<string>',
addressLine2: '<string>',
city: '<string>',
postalCode: '<string>',
state: '<string>',
taxNumber: '<string>'
},
paymentData: {stripeCustomerId: '<string>', paypalCustomerId: '<string>'}
})
};
fetch('https://api.fungies.io/v0/users/create', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fungies.io/v0/users/create",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'email' => 'jsmith@example.com',
'password' => '<string>',
'username' => '<string>',
'internalId' => '<string>',
'billingDetails' => [
'firstName' => '<string>',
'lastName' => '<string>',
'companyName' => '<string>',
'dialCode' => '<string>',
'phoneNumber' => '<string>',
'address' => '<string>',
'addressLine2' => '<string>',
'city' => '<string>',
'postalCode' => '<string>',
'state' => '<string>',
'taxNumber' => '<string>'
],
'paymentData' => [
'stripeCustomerId' => '<string>',
'paypalCustomerId' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-fngs-public-key: <api-key>",
"x-fngs-secret-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fungies.io/v0/users/create"
payload := strings.NewReader("{\n \"email\": \"jsmith@example.com\",\n \"password\": \"<string>\",\n \"username\": \"<string>\",\n \"internalId\": \"<string>\",\n \"billingDetails\": {\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"companyName\": \"<string>\",\n \"dialCode\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"address\": \"<string>\",\n \"addressLine2\": \"<string>\",\n \"city\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"state\": \"<string>\",\n \"taxNumber\": \"<string>\"\n },\n \"paymentData\": {\n \"stripeCustomerId\": \"<string>\",\n \"paypalCustomerId\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-fngs-public-key", "<api-key>")
req.Header.Add("x-fngs-secret-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fungies.io/v0/users/create")
.header("x-fngs-public-key", "<api-key>")
.header("x-fngs-secret-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"jsmith@example.com\",\n \"password\": \"<string>\",\n \"username\": \"<string>\",\n \"internalId\": \"<string>\",\n \"billingDetails\": {\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"companyName\": \"<string>\",\n \"dialCode\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"address\": \"<string>\",\n \"addressLine2\": \"<string>\",\n \"city\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"state\": \"<string>\",\n \"taxNumber\": \"<string>\"\n },\n \"paymentData\": {\n \"stripeCustomerId\": \"<string>\",\n \"paypalCustomerId\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fungies.io/v0/users/create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-fngs-public-key"] = '<api-key>'
request["x-fngs-secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"jsmith@example.com\",\n \"password\": \"<string>\",\n \"username\": \"<string>\",\n \"internalId\": \"<string>\",\n \"billingDetails\": {\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"companyName\": \"<string>\",\n \"dialCode\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"address\": \"<string>\",\n \"addressLine2\": \"<string>\",\n \"city\": \"<string>\",\n \"postalCode\": \"<string>\",\n \"state\": \"<string>\",\n \"taxNumber\": \"<string>\"\n },\n \"paymentData\": {\n \"stripeCustomerId\": \"<string>\",\n \"paypalCustomerId\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"status": "<string>",
"data": {
"user": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"object": "user",
"username": null,
"email": null,
"details": null,
"internalId": null
}
}
}{
"status": "error",
"error": {
"message": "Sample error message"
}
}Body
application/json
POST /v0/users/create Request body
Email of the user.
Example:
"test@example.com"
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 - 72Pattern:
[!"#$%&'()*+,-./:;<=>?@[\\\]^_`{|}~0-9]Example:
"Password123!"
Username of the User.
Minimum string length:
1Example:
"test-user"
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:
1Example:
"abcd-1234-5678-90ab-cdef-1234-5678-90ab"
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.
Show child attributes
Show child attributes
Example:
{
"type": "company",
"companyName": "Acme Sp. z o.o.",
"taxId": "eu_vat_poland",
"taxNumber": "PL1234567890",
"countryCode": "PL",
"firstName": "Jan",
"lastName": "Kowalski",
"dialCode": "+48",
"phoneNumber": "123456789",
"address": "ul. Marszałkowska 1",
"addressLine2": "lok. 10",
"city": "Warsaw",
"postalCode": "00-001"
}
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.
Show child attributes
Show child attributes
Example:
{
"stripeCustomerId": "cus_QzHuLRwfKfp2WX",
"paypalCustomerId": "KCE4828GQ37LL"
}
⌘I