Test Webhook
curl --request POST \
--url https://geniusforms.ai/api/v1/forms/{id}/webhook/test \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"url": "https://example.com/webhook"
}
'import requests
url = "https://geniusforms.ai/api/v1/forms/{id}/webhook/test"
payload = { "url": "https://example.com/webhook" }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({url: 'https://example.com/webhook'})
};
fetch('https://geniusforms.ai/api/v1/forms/{id}/webhook/test', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"statusCode": 200,
"error": "<string>"
}{
"error": "validation_error",
"message": "Invalid request"
}{
"error": "validation_error",
"message": "Invalid request"
}Webhooks
Test Webhook
Send a test payload to a webhook URL to verify it is reachable and responding correctly. If no URL is provided in the request body, the form’s configured webhook URL is used.
POST
/
forms
/
{id}
/
webhook
/
test
Test Webhook
curl --request POST \
--url https://geniusforms.ai/api/v1/forms/{id}/webhook/test \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"url": "https://example.com/webhook"
}
'import requests
url = "https://geniusforms.ai/api/v1/forms/{id}/webhook/test"
payload = { "url": "https://example.com/webhook" }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({url: 'https://example.com/webhook'})
};
fetch('https://geniusforms.ai/api/v1/forms/{id}/webhook/test', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"statusCode": 200,
"error": "<string>"
}{
"error": "validation_error",
"message": "Invalid request"
}{
"error": "validation_error",
"message": "Invalid request"
}Authorizations
API key obtained from your GeniusForms dashboard
Path Parameters
Form ID
Body
application/json
URL to test. If omitted, uses the form's configured webhook URL.
Example:
"https://example.com/webhook"