API Reference
The public delivery endpoint accepts authenticated email delivery requests.
POST /v1/email
Own Auth calls this endpoint through OwnAuthManagedEmailProvider. Apps normally do not call it by hand.
POST /v1/email
Authorization: Bearer oad_live_...
Content-Type: application/json
{
"to": "user@example.com",
"type": "magic_link",
"url": "https://your-app.com/auth/callback?token=...",
"expiresAt": "2026-07-09T12:00:00.000Z"
}{
"ok": true
}Request Fields
| Field | Required | Meaning |
|---|---|---|
| to | yes | Recipient email address. |
| type | yes | Email type. |
| url | yes | Auth URL created by Own Auth. It may use HTTPS, localhost or 127.0.0.1 for local development, or a configured app scheme. It must include only a non-empty token query parameter. |
| expiresAt | yes | ISO timestamp for when the auth link expires. |
| organisationName / org_name | no | Organisation name for invite emails. |
| inviterName / inviter_name | no | Inviter display name or email for invite emails. |
Response Codes
| Code | Meaning |
|---|---|
| 202 | Request queued. |
| 400 | Invalid request body or URL. |
| 401 | Missing or invalid delivery key. |
| 403 | URL is not allowed for the app. |
| 429 | Rate limit or daily limit reached. |