Developers
Designed around a small, predictable API
Authenticate from your backend, receive signed events, and keep every credential server-side.
API endpoints
| Method | Path | Description |
|---|---|---|
| POST | /v1/auth | Start an authentication request |
| GET | /v1/auth/:id | Fetch the status of a request |
| POST | /v1/auth/:id/verify | Confirm a verification |
| GET | /v1/projects | List your projects |
| POST | /v1/projects | Create a project |
| GET | /v1/webhooks | List webhook endpoints |
| POST | /v1/webhooks | Register a webhook endpoint |
| POST | /v1/webhooks/test | Send a signed test delivery |
| GET | /v1/usage | Read usage for a project |
Webhook events
- authentication.started
- authentication.completed
- authentication.failed
- verification.completed
- verification.failed
Signed delivery
Every delivery is signed with your endpoint secret so you can verify authenticity before processing the payload.
webhook
POST https://yourapp.com/api/teleauth/webhook
X-TeleAuth-Signature: sha256=<hmac>
{
"event": "authentication.completed",
"data": {
"id": "auth_8f21c4",
"project_id": "prj_your_project",
"status": "completed"
}
}Read the full integration guide.
View Documentation