Shifter Webhooks Explained

Shifter Webhooks can sends HTTP request to other host or service based on lifecycle events.

For more details, see our document.


Step I: Github

Fork Github repository

Fork our Github repository to your GitHub account. Create publishing branch (e.g. Publish, Deployment) if you need it.


Step II: Netlify

Connecting GitHub account, registering a Webhook URL

Click [New site from Git] button.

Click [Github] and log-in to it.

After authenticating access with Netlify, choose a repository publishing with web hook.

Click [Deploy site] button.

Click [Settings] menu.

Click [Build&Deploy].
Scroll down to Build hooks and input [Build hook name], choose [Branch to build] then click [Save].

Copy generated Build hooks URL.


Step III: Shifter

Set up Webhook publish and your test publish.

Login to Dashboard

Navigate to your site you want to publish.

Click [Webhooks] menu, then select or input the following items:

  • Event Type: Webhook:ArtifactCreated 

  • Method: POST 

  • URL: paste generated Build hooks URL on Netlify you copied above 

  • Headers Key (Optional)

  • Headers Value (Optional)

Click [Submit].

Webhook Body

The following items will be sent to Netlify.

  • site_id: Your Site ID

  • artifact_id : Artifact ID

  • download_url : BASE64 encoded URL signatured

Check Your Webhook to ensure its status is Enabled.

After that, generate artifact and check publish status with scrolling down this page.

You should get 200 (OK) if your Netlify Webhook publish was successful.

Need a different integration?

Using Webhooks you can send events to lots of places including Gitlab, WordPress and more.

You can even integrate Netlify with Slack to get publish status notifications.

Checkout Netlify's blog post and support document about Webhooks.

Did this answer your question?