WoyraDocs
Get an API key

Create an account

POST/v1/accounts

Accounts · Public: no credential needed

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

FieldTypeDescription
namerequiredstring
countrystringISO 3166-1 alpha-2. Drives which compliance rules apply.
currencystring
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.

FieldTypeDescription
object"account"
idstring
namestring
countrystring
currencystring
regionstringWhere this account's personal data lives.
One of global, ethiopia.
project_idstring
created_attimestamp
api_keyAPIKey

Errors

StatusCodes
400invalid_request, unsupported_version
404not_found, product_not_offered

Also in Accounts