Skip to main content

​
Notifications

Send email and SMS notifications to applicants on submission and status changes.

​
Channels

ChannelProviderUse Case
EmailResendSubmission receipts, status updates
SMSTwilioQuick confirmations, reminders

​
Notification Hub

Manage providers, templates, and delivery from one place:

​
Event Types

EventTrigger
submission_receiptForm submitted
status_changeStatus updated
reminderScheduled reminder

​
Template System

Custom templates with variable interpolation: 
Hello {{applicant.name}},

Your application for {{form.title}} has been {{submission.status}}.

Reference: {{submission.reference_id}}

​
Configuration

​
Per-Form Settings

  • Enable/disable email and SMS
  • Select notification fields (email, phone)
  • Choose templates per event

​
Sending

await sendNotification({
  formId,
  submissionId,
  eventType: "submission_receipt",
  email: {
    to: applicantEmail,
    subject: "Application Received",
    templateParams: { ... },
  },
  sms: {
    to: applicantPhone,
    body: "Your application was received. Ref: RENT-2024-001",
  },
});

​
Delivery Tracking

All notifications are logged: 
SELECT * FROM notification_events
WHERE submission_id = $1
ORDER BY sent_at DESC;

Queue Architecture

Async delivery

Webhooks

External notifications