Github integration

Using the Flood API to integrate with GitHub

To have Flood IO automatically repeat a test when you commit or submit a pull request, you need to create a webhook using the Flood API. You can repeat existing flood tests with the following endpoint:


Webhooks allow external services to be notified when certain events happen on GitHub. When the specified events happen, GitHub will send a POST request to each of the URLs you provide.


  • region optional target region to launch the test in
  • grid optional use a specific grid UUID to launch the test in instead of a region

If a grid region or uuid is not specified then the flood test will be repeated on all available grids for your account.


curl --silent -X POST


This webhook allows third party services to repeat a specific test, and allows anybody who has it to run a test against your server. If you think your webhook has been compromised you should delete the corresponding flood test from your account to prevent further use of that token.

Start load testing now

It only takes 30 seconds to create an account, and get access to our free-tier to begin load testing without any risk.