Getting started

From sign-up to your first API call in about five minutes.

1. Sign up & verify

Register at /register with an email + password. Confirm your email via the magic link, then verify your phone with the OTP. KYT review for your tenant is automatic for the common cases and takes a few minutes for the rest.

You can use the dashboard while KYT is pending, but /v1/* calls return 403 E_KYT_PENDING until your tenant is approved.

2. Issue an API key

From /settings/api-keys choose an environment (LIVE / TEST), the scopes you need (e.g. email:send), and click Issue. The secret is shown once; copy it now.

3. Send a first request

Try in playground →

curl -X POST https://api.valienz.io/v1/email/send \
  -H "Authorization: Bearer $VALIENZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@yourdomain.com",
    "to": ["dev@yourdomain.com"],
    "subject": "Hello from Valienz",
    "html": "<p>Hello world!</p>"
  }'

Track the send at /email. Every provider account in our rotation pool will compete for the request — the dashboard shows which one served it and the failover trail if any.

4. What next?

Add a BYO provider account so your tenant's sends bill against your own quota.
Configure rotation policy per product (weighted, least-cost, failover chain…).
Subscribe to webhook events to drive your own workflows.
Top up credits so you can stay above the pre-debit guard.