Getting startedSetting up

Setting up

Add a webhook and set its destination URL, events and optional secret header.

Webhooks are set up in the Integrations area of Settings.

What you set

SettingNotes
NameA label to recognise it, up to 100 characters.
Destination URLWhere Imploy sends events. See the rules below.
EventsThe events to send. Choose at least one; see Events.
Secret headerOptional. A header Imploy adds to every request, such as Authorization.

Destination URL rules

The destination must be a public HTTPS address:

  • HTTPS only, on port 443.
  • A public hostname that resolves to a public IP address. Private, reserved and Imploy addresses are refused.
  • No username or password in the URL, and no fragment.
  • imploy.com.au and its subdomains are not allowed.
  • Up to 2000 characters.

The secret header

If you set a secret header, Imploy sends it on every delivery, in addition to its own signature headers. Use it to reject requests that do not come from your webhook.

  • The name must be Authorization or start with X-, but not X-Imploy-.
  • The value is printable text.

When you change the destination URL of a webhook that has a secret header, you are asked to enter the secret again.

Was this page helpful?