Scroll to menu

Automatically deploy changes

Your site can be built by sending a POST request to:

https://builder.statichost.eu/YOUR_SITE_NAME

In order to build your site automatically, you can register this URL as a webhook receiver, and your site will be built and deployed whenever the webhook is triggered. The webhook should be sent whenever your site (e.g. content) changes.

For example this site is built automatically by a webhook added to its GitHub repository (using the instructions below). Whenever new commits to the main branch are pushed, the webhook is sent and site is built and deployed. Similarly, if your site uses a (non-git) CMS, a webhook can most likely be added whenever changes occur, triggering a build.

Examples of how to do this for various providers are available here.

Authentication

At the moment, the build trigger webhook is unauthenticated by default. This means that anyone who knows the name of a site can trigger a build for that site. In practice, the worst someone can do by triggering an unwanted build is waste some build resources and time. This may not be ideal, especially if the build depends on other services.

You can enable authentication for the webhook in the site settings, under Source & build. Once you do that, you need to send an API key along with the POST request by adding the Authorization: Bearer API_TOKEN HTTP header. API keys can be created from the My account area.