Webhook Integration
Overview Loadmance webhooks allow you to receive real-time notifications about test events and test builder operations in your application. When configured, Loadmance will send HTTP POST requests to your specified endpoint with event data.
Setup 1. Navigate to your profile settings in Loadmance 2. Go to the "Integrations" section 3. Select "Webhook" and enter your endpoint URL 4. Choose which events you want to receive notifications for 5. Save the configuration
Webhook Request Format
Headers
Note: You can configure additional custom headers in your webhook settings.
Request Body Structure
Event Types and Metadata Fields TEST_STARTED Triggered when a load test begins execution.
Metadata Fields:
testRunId (string): Unique identifier for the test run
maxUser (string): Maximum number of virtual users
duration (string): Test duration in seconds
watchLive (string): Report address link
Example:
TEST_FINISH Triggered when a load test completes successfully.
Metadata Fields:
testRunId (string): Unique identifier for the test run
status (string): Final test status (FINISHED, FAILED etc.)
duration (string): Actual test duration in seconds
maxUser (string): Maximum number of virtual users reached
totalRequestCount (string): Total number of requests made
avgResponseTime (string): Average response time in milliseconds
throughput (string): Requests per second
apdexScore (string): Apdex score (0.0 to 1.0)
runningTime (string): Running time
reportLink (string): Report link
Example:
TEST_FAILED
Triggered when a load test fails or encounters an error.
Metadata Fields:
testRunId (string): Unique identifier for the test run
duration (string): Duration until failure in seconds
totalRequestCount (string): Total requests made before failure
errorRate (string): Error rate as a percentage (0-100)
avgResponseTime (string): Average response time before failure
runningTime (string) Running time
failReportLink (string): Failed report link address
Example:
TEST_BUILDER_CREATED
Triggered when a new test builder is created.
Metadata Fields:
testBuilderId (string): Unique identifier for the test builder
testBuilderTitle (string): Name/title of the test builder
projectId (string): Project identifier
projectName (string): Project name
Example:
TEST_BUILDER_UPDATED
Triggered when an existing test builder is modified.
Metadata Fields:
testBuilderId (string): Unique identifier for the test builder
testBuilderTitle (string): Name/title of the test builder
projectId (string): Project identifier
projectName (string): Project name
TEST_BUILDER_DELETED
Triggered when a test builder is deleted.
Metadata Fields:
testBuilderId (string): Unique identifier for the test builder
testBuilderTitle (string): Name/title of the test builder
projectId (string): Project identifier
projectName (string): Project name
PROJECT_CREATED
Triggered when a new project is created.
Metadata Fields:
No metadata fields are included for project events
Example:
PROJECT_UPDATED
Triggered when an existing project is modified.
Metadata Fields:
No metadata fields are included for project events
Example:
PROJECT_DELETED
Triggered when a project is deleted.
Metadata Fields:
No metadata fields are included for project events
Example:
Severity Levels
INFO: Informational events (test started, builder created/updated, project events)
SUCCESS: Successful completion events (test finished successfully)
WARNING: Warning events (performance thresholds exceeded)
ERROR: Error events (test failed, critical issues)
Endpoint Requirements
Response
Your webhook endpoint should respond with:
Status Code: 200-299 for successful processing
Response Time: Under 10 seconds
Content: Any response body (ignored by Loadmance)
Retry Logic
Loadmance will retry failed requests up to 3 times (4 total attempts)
Retry intervals use exponential backoff: 1 second, 2 seconds, 4 seconds
Maximum delay between retries is capped at 10 seconds
Requests timing out after 10 seconds will be retried
Last updated