Skip to content
MothershipDevelopers

Webhook eventsTesting

Test webhook

Sent when someone clicks Send test on an endpoint in the dashboard.

EVENTwebhook.test
POST to your endpointSigned with HMAC-SHA256Sent once, no retries
RequestPOSThttps://your-server.example.com/webhooks/mothership
Content-Type:application/json
X-Mothership-Signature:fe7a6405b395fbf5deb8079dc24df7e83c0ff131f81816e0868cb3c76c428343
X-Mothership-Delivery-Id:3f6c1a9e-8b2d-4c7a-9e15-2d8b7f4a6c01
{
: "webhook.test",
: {
: "-OB3xk2Yq9mFv1aZ7Lw0",
: "A test webhook from Mothership. Answer with any 2xx status to show this endpoint works."
},
: "2026-10-08T15:04:05.000Z",
: 1,
: 0
}

Hover a key to see what it means. Click it to jump to the field.

Clicking Send test on an endpoint on the Webhooks page in the dashboard posts one webhook.test to that endpoint, whatever events it subscribes to. Use it to check your endpoint answers and verifies signatures before real events arrive.

It is signed and carries X-Mothership-Delivery-Id like every other event. It is sent once without retries, so pendingRetries is 0. No configuration can subscribe to it. Answer it with any 2xx and ignore it in your event handling.

Subscribing

No configuration subscribes to it. It goes only to the endpoint you test, from the Webhooks page in the dashboard.

Event data

data · 2 keys
  • webhookConfigIdstring

    The ID of the webhook configuration the test went to.

  • messagestring

    A fixed message. It names no shipment, so it can't be mistaken for a real event.

Envelope

Same on every event
  • eventTypestring

    The event. Always webhook.test here. Route on it, and answer 2xx to types you don't handle.

  • sentAtstring

    When Mothership queued the event to send, as an ISO 8601 string in UTC. Every retry and resend carries the same value, so it does not say when this attempt went out.

  • deliveryAttemptinteger

    Which send of this event this is, starting at 1. Resends from the dashboard count too.

  • pendingRetriesinteger

    How many automatic attempts are left if this one fails. 0 on the last one.

Related

Receiving webhooksVerify the signature, answer within 30 seconds, and handle retries and duplicates.