digital-identity-platform-docs
digital-identity-platform-docs / supabase/functions/send-invitation-email
supabase/functions/send-invitation-email
Fileoverview
Send Invitation Email Edge Function
Sends team invitation emails via SMTP. Used when an admin invites a new team member to join their organization.
Cloudflare Architecture Context
| Attribute | Value |
|---|---|
| Classification | 🔵 BACKEND-ONLY |
| Position | App Backend (email delivery) |
| Receives Public Traffic | No (internal calls only) |
| Latency Sensitive | No |
| Safe to Retry | Yes (sending duplicate emails is acceptable) |
| Failure Behavior | Returns error (caller may continue) |
Endpoint
POST /send-invitation-email
Auth
Required - JWT verified by Supabase
Remarks
- Requires SMTP configuration via environment variables:
- SMTP_HOST: SMTP server hostname
- SMTP_PORT: SMTP port (default 465 for TLS)
- SMTP_USER: SMTP username (also used as sender email)
- SMTP_PASS: SMTP password
- Generates HTML email with invitation link to app.qaxal.com
- Invitation links expire in 7 days (mentioned in email)
- Uses denomailer library for SMTP communication
Example
json
{
"email": "newuser@example.com",
"organizationName": "Acme Corp",
"role": "admin",
"token": "abc123-invitation-token",
"inviterEmail": "admin@example.com"
}