Quickstart

Prerequisites

• A Veilio account and API key from Dashboard → API Keys
• A backend environment (never call Veilio with secrets from frontend or mobile code)
• curl installed (or use the JavaScript / Python SDK)

1) Create an API key

1. Sign in at app.veilio.fr.
2. Open Dashboard → API Keys.
3. Click Create API key, choose Standard purpose for day-to-day operations.
4. Copy the key once — it is shown only at creation time.

2) Set environment variables

export VEILIO_API_KEY="01234567890123456789012345678901"
export VEILIO_BASE_URL="https://app.veilio.fr/api"

For on-premise deployments, set VEILIO_BASE_URL to your instance URL, e.g. https://veilio.your-company.com/api.

3) Tokenize a sensitive value

curl -s -X POST "$VEILIO_BASE_URL/tokenize" \
  -H "Authorization: Bearer $VEILIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data":"support@veilio.fr","type":"email"}'

Expected response:

{
  "token": "tok_abc123...",
  "createdAt": "2026-03-26T1000.000Z"
}

Store only token in your database — never the raw email.

4) Detokenize when required

curl -s -X POST "$VEILIO_BASE_URL/detokenize" \
  -H "Authorization: Bearer $VEILIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token":"tok_abc123...","reason":"Send user notification"}'

Expected response:

{
  "data": "support@veilio.fr",
  "accessedAt": "2026-03-26T1000.000Z"
}

The reason field is logged for audit and compliance.

5) Recommended application pattern

Next steps

Related links

• Product website: https://veilio.fr
• Contact : https://veilio.fr/contact