Authentication

Luella uses a simplified authentication system that does not rely on API keys or OAuth tokens.

Instead, each user is issued two values:

• userId: uniquely identifies the user.
• workspaceId: identifies the Luella workspace the user belongs to.

These values must be included in the body of every POST request made to the Luella API.

How to get your credentials

To obtain your userId and workspaceId, please send an email to:

adb@luella.ai

Include the following information in your request:

• Your full name or team name
• Your Luella workspace name
• The email address associated with your Luella account

Once validated, you will receive your userId and workspaceId via email.

⚠️ Important: Never share your userId or workspaceId with anyone outside your team. These values identify your API access and can be used to access sensitive campaign and email infrastructure.

Including credentials in your request

These two fields must be passed as part of the JSON request body for every API call:

{
  "userId": "your_user_id",
  "workspaceId": "your_workspace_id",
  "maxItems": 10
}

All Luella endpoints are POST requests. There is no authentication via headers or query params.

Example

Here’s an example curl call to ListClusters:

curl -X POST https://api.luella.ai/clusters/ListClusters \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "your_user_id",
    "workspaceId": "your_workspace_id",
    "maxItems": 5
  }'

By following this structure, you’ll be authenticated on every request and able to access your organization’s email data and campaign setup securely.