Skip to main content
The Stannp plugin handles incoming webhooks. Point your provider’s subscription URL at your Corsair HTTP handler (see Overview for setup context and the exact URL shape).
New to Corsair? See webhooks and hooks.

Webhook map

  • campaigns
    • status (campaigns.status)
  • events
    • created (events.created)
  • mailpieces
    • status (mailpieces.status)
  • webhooks
    • testUrl (webhooks.testUrl)

HTTP handler setup

app/api/webhook/route.ts

Events

Campaigns

Status

campaigns.status A campaign changed status: printing, dispatched or cancelled; up to 50 campaigns per call Payload
webhookHooks example

Events

Created

events.created A new recipient event was recorded; up to 50 events per call Payload
webhookHooks example

Mailpieces

Status

mailpieces.status A mailpiece changed status: printing, dispatched, cancelled, local_delivery, delivered or returned; up to 50 mailpieces per call Payload
webhookHooks example

Webhooks

Test Url

webhooks.testUrl Validation POST sent once when a webhook is created; the platform keeps the webhook only if this answers HTTP 200 Payload
webhookHooks example