Platform
API Keys
Create and manage API keys to authenticate your requests to the Render25 API.
Create an API Key
Navigate to Settings → API Keys in the Render25 dashboard and click New API Key.
One-time display
The API key is only shown once at creation. Copy it and store it securely (e.g., in a secrets manager). If you lose it, you must revoke and regenerate.
Key Permissions
Each API key can be scoped to specific actions:
| Scope | Description |
|---|---|
email:send | Send transactional emails |
email:logs:read | Read email delivery logs |
domains:read | List and view domains |
domains:write | Add and verify domains |
webhooks:manage | Create and delete webhooks |
Revoke a Key
To revoke a key, go to Settings → API Keys, find the key, and click Revoke. Revocation is immediate and cannot be undone.
Immediate effect
Revoking a key will immediately reject all requests using that key. Make sure to rotate any systems using the key before revoking.
Revoke via API
bash
curl -X DELETE https://api.render25.com/v1/api-keys/key_01J3K9X7YD \
-H "Authorization: Bearer YOUR_ADMIN_API_KEY"