Test event
POST
Sent when someone presses “Send test event” on a destination in the app.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Header Parameters
Section titled “Header Parameters”Midwater-Signature
required
string
Example
t=1791493920,v1=5f1410b3599929147ad7559ca8423d05b723079614d80aa9763d17b440a899e3t=<unix seconds>,v1=<hex>: HMAC-SHA256 of <t>.<raw body> keyed with the environment’s signing secret (whsec_…). Verify with a 5-minute tolerance and a constant-time compare, and accept the delivery if any v1= value matches.
Midwater-Event
required
string
The event type, the same as the body’s type.
Midwater-Delivery
required
string
The delivery ID; the same on every retry of one delivery. Deduplicate on it.
Request Body
Section titled “Request Body”Media typeapplication/json
object
id
required
Event ID, evt_….
string
type
required
string
environment
required
Webhooks fire for live conversations, and for test ones only when the destination or route opts in.
string
created_at
required
string format: date-time
data
required
object
type
required
data
required
object
message
string
Example
This is a test event from Midwater.destination
string
url
string format: uri
Responses
Section titled “Responses”Any 2xx within 5 seconds marks the delivery as delivered. Anything else, or no answer in time, is retried: today 3 retries about 2, 8 and 30 seconds apart; planned: 8 attempts over about 24 hours.