Loading...

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 push

Set 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-monitor

Configure 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, and monitor_id in public.pingalert_incidents.

Management path

  • Use a real Supabase Auth user JWT when invoking JWT-protected functions.
  • Test invalid inputs such as intervalSeconds: 45 and bad action values.
  • Test isEnabled: false on create and confirm it is disabled after creation.
  • Verify upstream PingAlert 4xx errors are returned as 4xx.

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.