Integration Docs
Supabase uptime monitoring integration docs
Step-by-step setup for developers adding PingAlert to a Supabase project. Covers the deployment sequence, required secrets, webhook setup, and the checks to run in staging before going live.
Already have a PingAlert account? Log in
Setup at a glance
- 01One migration and four Edge Functions
- 02Three Supabase secrets to set
- 03Webhook URL on your own Supabase project
- 04Staging tests for webhooks and monitor management
Checklist
- Link a staging Supabase project.
- Run
supabase db push. - Set PingAlert secrets.
- Deploy four Edge Functions.
- Test signed webhook delivery and dedupe.
- Test monitor create, update, and pause-management functions.
1. Deploy the integration
Link and push
supabase link --project-ref <project-ref>
supabase db pushSet required secrets
supabase secrets set PINGALERT_API_BASE_URL=https://api.pingalert.io
supabase secrets set PINGALERT_WEBHOOK_SECRET=<webhook-secret>
supabase secrets set PINGALERT_API_KEY=<token-or-api-key>Deploy functions
supabase functions deploy pingalert-webhook --no-verify-jwt
supabase functions deploy create-pingalert-monitor
supabase functions deploy update-pingalert-monitor
supabase functions deploy pause-pingalert-monitorConfigure PingAlert webhook delivery
Point PingAlert at https://<project-ref>.supabase.co/functions/v1/pingalert-webhook. If you need workspace routing inside one Supabase project, append ?tenant_id=<value>.
2. Test in staging before going live
Webhook path
- Send an invalid signature request and confirm
401. - Send a valid signed request and confirm
200. - Replay the same request and confirm dedupe still returns
200. - Verify
tenant_id,event_type, andmonitor_idinpublic.pingalert_incidents.
Management path
- Use a real Supabase Auth user JWT when invoking JWT-protected functions.
- Test invalid inputs such as
intervalSeconds: 45and badactionvalues. - Test
isEnabled: falseon create and confirm it is disabled after creation. - Verify upstream PingAlert
4xxerrors are returned as4xx.
Start with PingAlert
Create a PingAlert account, then connect your Supabase project.
Sign up for the free plan, create your first webhook or API credential, and use these integration docs to finish the Supabase setup.
PingAlert integration for Supabase: incidents in Postgres and monitor management from Edge Functions.