Create an account
Creates an account and returns a working **test** API key in the same response. That is deliberate: the target is a working API call within 90 seconds of signup, and a flow that needs a second call to mint a key has already spent most of them.
**The country endpoint sets the defaults.** Signing up on ethiopia.woyra.io gives an Ethiopian account billed in ETB with Ethiopian data residency, without asking for any of it. Passing country or currency explicitly overrides that — a customer may sign up on the Ethiopian endpoint while incorporated elsewhere.
The key is a test key, so the first call succeeds without a verified domain or a funded balance.
Available only on deployments with open signup enabled; elsewhere this path returns 404.
Body
| Field | Type | Description |
|---|---|---|
| namerequired | string | |
| country | string | ISO 3166-1 alpha-2. Drives which compliance rules apply. |
| currency | string | One of USD, EUR, GBP, NGN, KES, ETB, ZAR. |
Example
curl -X POST https://api.woyra.io/v1/accounts \
-H 'Content-Type: application/json' \
-d '{
"name": "<name>"
}'Response
201 The account, with its first API key.
| Field | Type | Description |
|---|---|---|
| object | "account" | |
| id | string | |
| name | string | |
| country | string | |
| currency | string | |
| region | string | Where this account's personal data lives. One of global, ethiopia. |
| project_id | string | |
| created_at | timestamp | |
| api_key | APIKey |
Errors
| Status | Codes |
|---|---|
| 400 | invalid_request, unsupported_version |
| 404 | not_found, product_not_offered |
Also in Accounts
- GET /v1/account — Describe the calling account