Send a test webhook
curl --request POST \
--url https://api.opper.ai/v3/webhooks/test \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"callback_url": "<string>"
}
'import requests
url = "https://api.opper.ai/v3/webhooks/test"
payload = { "callback_url": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({callback_url: '<string>'})
};
fetch('https://api.opper.ai/v3/webhooks/test', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"delivered": true,
"duration_ms": 123,
"webhook_id": "<string>",
"error": "<string>",
"status_code": 123
},
"meta": {}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {}
}Webhooks
Send a test webhook
Send one signed webhook.test event to callback_url now, to check that your endpoint is reachable and verifies signatures, without running a job. The URL goes through the same checks as a job’s callback_url (400 names the rule it broke), and the event is signed with the project’s secret like any other. One attempt, no retries: the answer says whether your endpoint took it (delivered, a 2xx), its status_code, or what went wrong. At most 10 a minute per project (429).
POST
/
v3
/
webhooks
/
test
Send a test webhook
curl --request POST \
--url https://api.opper.ai/v3/webhooks/test \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"callback_url": "<string>"
}
'import requests
url = "https://api.opper.ai/v3/webhooks/test"
payload = { "callback_url": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({callback_url: '<string>'})
};
fetch('https://api.opper.ai/v3/webhooks/test', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"delivered": true,
"duration_ms": 123,
"webhook_id": "<string>",
"error": "<string>",
"status_code": 123
},
"meta": {}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {}
}See the Webhooks guide for setup, signature verification and retries.
Last modified on November 3, 2026