Create Webhook
Create a signed webhook endpoint.
Create a signed webhook endpoint.
Scope: email_testing.webhooks.write
Request Body
urlstringrequiredThe public HTTP or HTTPS URL that should receive webhook events, for example https://example.com/webhooks/email-testing.
eventsstring[]requiredThe events to send to this URL, for example ["message.received", "analysis.completed"]. See Getting Started with Webhooks for the full list.
Sample Request
Request
curl -X POST "https://api.maileroo.com/v1/email-testing/webhooks" \
-H "Authorization: Bearer roo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/hooks","events":["message.received"]}'Sample Response
The response is wrapped in a data object.
Response
{
"data": {
"id": "b574649c-9f0c-4077-9b13-c86e3c2840ee",
"url": "https://example.com/hooks",
"events": [
"message.received",
"analysis.completed"
],
"secret": "64-lowercase-hex-secret",
"status": "active",
"created_at": "2025-01-01T12:00:00Z"
}
}Errors
400 Bad Request— the URL or event list is invalid.429 Too Many Requests— the account has reached its webhook limit.