Skip to main content
POST
/
api
/
webhooks
/
mails
MAILS Webhooks
curl --request POST \
  --url https://api.example.com/api/webhooks/mails

Documentation Index

Fetch the complete documentation index at: https://docs.nullpass.xyz/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

POST /api/webhooks/mails

​
Overview

Receives and processes Polar webhooks for MAILS service subscriptions. Updates user entitlements based on subscription events.

​
Security

Webhook secret: MAILS_POLAR_SECRET environment variable

​
Implementation

export const POST = Webhooks({
  webhookSecret: process.env.MAILS_POLAR_SECRET!,
  onPayload: async (payload) => {
    await handlePolarWebhook(payload, 'MAILS')
  },
})

​
Supported Events

See Webhooks Overview for complete list of supported events.

​
Service-Specific Behavior

When processing MAILS webhooks:
  • Updates UserServiceEntitlement with service: 'MAILS'
  • Links Polar customer and subscription IDs
  • Updates tier and premium status
  • Sends Discord notifications (if configured)

​
Configuration

Set MAILS_POLAR_SECRET in environment variables to match Polar webhook secret.