Skip to main content
POST
/
api
/
v1
/
cashout
/
users
curl -X POST https://api.zebedee.io/api/v1/cashout/users \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reference_id": "player-42",
    "email": "player@example.com"
  }'

{
  "success": true,
  "data": {
    "id": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652",
    "reference_id": "player-42",
    "email": "player@example.com"
  }
}

​
Description

Provisions a user in ZBD for your project. Idempotent — if a user with the same reference_id or email already exists for your project, the existing user is returned. Call this from your server before creating a widget session.

​
Configuration

​
Header Parameters

​
apikey
string
required
Your ZBD project API key (production scope).
​
Content-Type
string
Content Type

​
Body Parameters

​
reference_id
string
required
Your stable internal user identifier. Must be unique per project.
​
email
string
required
User’s email address. Used for OTP verification in the widget.
curl -X POST https://api.zebedee.io/api/v1/cashout/users \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reference_id": "player-42",
    "email": "player@example.com"
  }'

{
  "success": true,
  "data": {
    "id": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652",
    "reference_id": "player-42",
    "email": "player@example.com"
  }
}