Skip to main content
Register
curl --request POST \
  --url https://api-staging.genuka.com/2023-11/developer/auth/register \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company": {
    "currency_code": "XAF",
    "name": "Evolutive Games"
  },
  "user": {
    "email": "[email protected]",
    "first_name": "Takam",
    "last_name": "Rushclin",
    "password": "[email protected]",
    "phone": null
  }
}
'
{
  "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxIiwianRpIjoiMGU3NDgxOWFhNzY0MGNjNWViZWE2YzVkNjlkMmY5ZDA4NjViOGUzNTM4ZTdiZDFlNWE2ZDMzZGIwYjA0NjY0ZWZhMjIyYzQwMTgyZmFlYzYiLCJpYXQiOjE3MDIzNjk3NTkuODA5MzA1LCJuYmYiOjE3MDIzNjk3NTkuODA5MzEsImV4cCI6MTczMzk5MjE1OS42MjI3MzEsInN1YiI6IjAxaGhlamEzNjhzeHAyeDJuZHFlY243dGo2Iiwic2NvcGVzIjpbIioiXX0.JxJavOQQj4Hry6V6I0NjERorJqQX4rvR7XLZmwCk3kdvat6-vXjQqC-qSW_xvCaYh080fMPOjVmqHa84HgwuQrs50fUrnbcbUOasnr9IlAVA2xSS_9432QyUJkKwfYU9u2k7DRUkF1VzITdqEYZ7oG_BgRd3BRf_N8Ce_4LGaKskL2BSHhpc9CAwXxreYbXsvWYAexZc5B_sOsUDFjBI1Z37pzrVE_OSI0hwVrgYi4VPH3gxLsPtX5idR2HactJ3GGHgnY4TtAlN6HjfPx7_m7-LqllYc85Y4lKBYBNr-pEVYeg6PdzbakYyVCvcm1nnhKxd7tG_kvLtA_IvNgRXpRkZo-rve7P1a5-8wUFLj2vy3hF6NR-hju_rFrpvQRBrUFCvJ7oEFelgfenkoWoQHKmuh9olfsXo6POV1A9cefFRmha5kmZxvh0PPK2kB9NtnpVJisPdk2nbnl7vzuNqWL8XEkBtkfvG2u8YjqvyCFIrea_wV_YEcgdQWKUkhDzjXJCdYtyWULHFtuLZuelwVEegNUEodvDzrdH0pn9BiUDjqN2RMaU5rwkEvKRhp7ow5DwbbMKFJ3UCa1OsQ3BfuA_NRdSib8LyKHvBzCZ5YhP_KwKKFzj2qKQ0VSfvwKdXPdyRPCP6STqvIoBmVO8Wa--LmavltXcaQslNcUeECcg",
  "companyId": "01hheja204e7hya2rgjgbwxts3",
  "token": {
    "client_id": 1,
    "created_at": "2023-12-12T08:29:19.000000Z",
    "expires_at": "2024-12-12T08:29:19.000000Z",
    "id": "0e74819aa7640cc5ebea6c5d69d2f9d0865b8e3538e7bd1e5a6d33db0b04664efa222c40182faec6",
    "name": "Wilfried Djopa",
    "revoked": false,
    "scopes": [
      "*"
    ],
    "updated_at": "2023-12-12T08:29:19.000000Z",
    "user_id": "01hheja368sxp2x2ndqecn7tj6"
  }
}

​
Overview

The Create Account API allows developers to programmatically register new user accounts on the Genuka platform. This endpoint is essential for applications that need to onboard users directly through their own interface while leveraging Genuka’s comprehensive business management features.
This endpoint creates a new user account with basic authentication credentials. After successful registration, users will have access to create and manage their business data through the Genuka platform.

​
Use Cases

This API endpoint is typically used for:
  • Custom onboarding flows - Integrate account creation directly into your application’s user experience
  • Third-party integrations - Allow other platforms to create Genuka accounts for their users

​
Security Considerations

  • Password Requirements: Minimum 8 characters with at least one uppercase letter, one number, and one special character
  • Rate Limiting: Account creation is limited to 10 requests per IP address per hour to prevent abuse
  • Duplicate Prevention: Email addresses can only be associated with one active account

​
Response Data

Upon successful account creation, the API returns:
  • User ID: Unique identifier for the newly created account
  • Account Status: Current status (pending verification, active, etc.)
  • Access Tokens: Initial authentication tokens for immediate API access
Store the returned access tokens securely. They provide immediate API access and should be handled according to your application’s security best practices.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
company
object
​
user
object

Response

200 - application/json

UserRegistered

​
accessToken
string
Example:

"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxIiwianRpIjoiMGU3NDgxOWFhNzY0MGNjNWViZWE2YzVkNjlkMmY5ZDA4NjViOGUzNTM4ZTdiZDFlNWE2ZDMzZGIwYjA0NjY0ZWZhMjIyYzQwMTgyZmFlYzYiLCJpYXQiOjE3MDIzNjk3NTkuODA5MzA1LCJuYmYiOjE3MDIzNjk3NTkuODA5MzEsImV4cCI6MTczMzk5MjE1OS42MjI3MzEsInN1YiI6IjAxaGhlamEzNjhzeHAyeDJuZHFlY243dGo2Iiwic2NvcGVzIjpbIioiXX0.JxJavOQQj4Hry6V6I0NjERorJqQX4rvR7XLZmwCk3kdvat6-vXjQqC-qSW_xvCaYh080fMPOjVmqHa84HgwuQrs50fUrnbcbUOasnr9IlAVA2xSS_9432QyUJkKwfYU9u2k7DRUkF1VzITdqEYZ7oG_BgRd3BRf_N8Ce_4LGaKskL2BSHhpc9CAwXxreYbXsvWYAexZc5B_sOsUDFjBI1Z37pzrVE_OSI0hwVrgYi4VPH3gxLsPtX5idR2HactJ3GGHgnY4TtAlN6HjfPx7_m7-LqllYc85Y4lKBYBNr-pEVYeg6PdzbakYyVCvcm1nnhKxd7tG_kvLtA_IvNgRXpRkZo-rve7P1a5-8wUFLj2vy3hF6NR-hju_rFrpvQRBrUFCvJ7oEFelgfenkoWoQHKmuh9olfsXo6POV1A9cefFRmha5kmZxvh0PPK2kB9NtnpVJisPdk2nbnl7vzuNqWL8XEkBtkfvG2u8YjqvyCFIrea_wV_YEcgdQWKUkhDzjXJCdYtyWULHFtuLZuelwVEegNUEodvDzrdH0pn9BiUDjqN2RMaU5rwkEvKRhp7ow5DwbbMKFJ3UCa1OsQ3BfuA_NRdSib8LyKHvBzCZ5YhP_KwKKFzj2qKQ0VSfvwKdXPdyRPCP6STqvIoBmVO8Wa--LmavltXcaQslNcUeECcg"

​
companyId
string
Example:

"01hheja204e7hya2rgjgbwxts3"

​
token
object