Send a test webhook | Saperly Docs

Sends a test webhook to the specified line’s webhook URL. Useful for verifying webhook endpoint connectivity and response handling. The outbound payload is a TestEvent and carries the three signature headers (x-saperly-timestamp, x-saperly-delivery-id, x-saperly-signature). See the TestEvent and WebhookSignatureHeaders schemas for shape, and webhook mode — signature verification for the verification flow.

Sends a test webhook to the specified line's webhook URL. Useful for verifying webhook endpoint connectivity and response handling. The outbound payload is a `TestEvent` and carries the three signature headers (`x-saperly-timestamp`, `x-saperly-delivery-id`, `x-saperly-signature`). See the `TestEvent` and `WebhookSignatureHeaders` schemas for shape, and [webhook mode — signature verification](https://saperly.com/docs/guides/webhook-mode#signature-verification) for the verification flow.

Authentication

AuthorizationBearer

Send as Authorization: Bearer <your-key>. Obtain keys from the portal — prefix sk_live_ for production, sk_test_ for sandbox.

Request

This endpoint expects an object.

line_idstringRequiredformat: "uuid"

ID of the line whose webhook URL to test

Response

Test result

deliveryobject

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

1	const url = 'https://saperly.com/api/v1/webhooks/test';
2	const options = {
3	method: 'POST',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{"line_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"delivery": {
3	"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
4	"status": "success",
5	"http_status": 200,
6	"duration_ms": 150,
7	"response_body": "{\"message\":\"Webhook received successfully\"}"
8	}
9	}