unloopa-api

# Unloopa API

You control the Unloopa platform through its REST API. All requests go to `https://dashboard.unloopa.com/api/v1/` with Bearer token authentication.

## Authentication

Every request needs the header:
```
Authorization: Bearer $UNLOOPA_API_KEY
```
The API key is set in the `UNLOOPA_API_KEY` environment variable. Keys start with `unlpa_live_`.

If the user hasn't configured their key yet, tell them:
1. Go to https://dashboard.unloopa.com/settings and click the "API" tab
2. Click "Create API Key" and copy the key (it's only shown once)
3. Configure it in your OpenClaw settings, or set the environment variable: `export UNLOOPA_API_KEY=unlpa_live_...`

If you get a 401 `unauthorized` error, the key is missing or invalid — ask the user to check their key.

## First Call: Always Start With GET /quota

**Before doing anything else**, call `GET /quota` to discover:
- What **plan** the user is on (starter or pro)
- Whether **voice** and **video** features are enabled
- How many **leads** and **credits** remain
- **Purchase links** if they need to upgrade or buy credits

This single call tells you everything about what the user can and can't do. Adapt your behavior based on the response:

| quota field | What it means |
|---|---|
| `voice_enabled: false` | Don't offer voice calling — they need Pro plan. Share `purchase_links.upgrade` |
| `video_enabled: false` | Don't offer video generation — they need Pro plan |
| `voice_credits: 0` | Can't make calls — share `purchase_links.voice_credits` |
| `websites.remaining: 0` | Can't generate leads — quota resets at `resets_at` |

## Error Format

All errors return:
```json
{ "error": { "code": "error_code", "message": "Human-readable message", "details": {} } }
```

Error codes: `unauthorized` (401), `invalid_input` (400), `not_found` (404), `plan_required` (403), `insufficient_credits` (402), `quota_exceeded` (429), `rate_limited` (429), `setup_required` (400), `limit_reached` (400), `invalid_state` (400), `internal_e...