test

A special test event that can be triggered manually from the SIPSIM dashboard. Use it to verify that your webhook endpoint is reachable, correctly configured, and able to validate signatures — without waiting for a real call event.

When This Event Fires

• You click the Send Test button in the webhook settings modal on the SIPSIM dashboard

This event is never sent automatically. It is only triggered by manual user action.

How to Send a Test Webhook

1. Go to Integrations in the SIPSIM dashboard
2. Open your Webhook settings
3. Click the Send Test button
4. A test POST request is sent to your configured webhook URL
5. The result (success or error) is displayed in the dashboard

Payload

Field	Type	Description
event	string	Always "test"
message	string	A human-readable confirmation message
timestamp	string	ISO 8601 timestamp of when the test was sent
pbx_id	string	Always "test_000000"

Example Payload

{
  "event": "test",
  "message": "This is a test webhook from SIPSIM. If you receive this, your endpoint is configured correctly.",
  "timestamp": "2025-01-15T10:30:00Z",
  "pbx_id": "test_000000"
}

Headers

The test event includes the same signature headers as all other events:

Header	Description
X-Webhook-Signature	HMAC-SHA256 hex digest
X-Webhook-Timestamp	Unix timestamp used in signing
Content-Type	application/json

This means you can use the test event to verify your signature verification implementation.

Dashboard Feedback

After sending the test, the dashboard shows one of:

Result	Meaning
Success (HTTP 2xx)	Your endpoint received the webhook and responded successfully
Connection failed	SIPSIM could not reach your URL — check that it's publicly accessible
Error (HTTP 4xx/5xx)	Your endpoint returned an error — check your server logs

Related Events

• incoming_call_start — a real incoming call event to test with live data