Guest

The guest API allows onboarding guest users and generating access tokens.

create-guest

Creates a new guest user with personal information (PII). This is the first step in the widget onboarding process.

SecurityAuthorization
Request
Request Body schema: application/json
required
email
required
string <email>
required
object
Responses
201

Guest created successfully.

post/v3/auth/create-guest-with-pii
Request samples
application/json
{
  • "email": "guest@crymbo.com",
  • "pii": {
    }
}

generate-guest-token

Generates a token for an existing guest user. This token is required to access protected parts of the widget and must be included in the widget URL.

SecurityAuthorization
Request
Request Body schema: application/json
required
username
required
string <email>
Responses
200

Token successfully generated.

401

Unauthorized - User not found or invalid credentials.

post/v3/auth/generate-guest-token
Request samples
application/json
{
  • "username": "guest@crymbo.com"
}
Response samples
application/json
{
  • "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}