Skip to main content

Receive webhooks

Updated October 10, 2026

Webhooks send InfluenceBot events to your own HTTPS endpoints as they happen, for example when a post is published, a job finishes or credits run low. Every delivery is signed so your system can check it came from InfluenceBot.

Add an endpoint

  1. Go to Settings → Webhooks.
  2. Under Add an endpoint, enter the Endpoint URL. It must be a public https:// URL on port 443.
  3. Optionally add a Description.
  4. Choose the Events, or All events, including types added later.
  5. Click Add endpoint.
  6. Copy the Signing secret and click I’ve stored it. It is never shown again.

You can have up to 20 endpoints per workspace.

Verify deliveries

Give these points to the person who builds the receiver. The full steps are under Verify signatures on the endpoint page.

  • Check the InfluenceBot-Signature header with the signing secret, and reject old deliveries.
  • Use the InfluenceBot-Event-Id header to ignore duplicates: retries and replays reuse the same event id.
  • Answer with any 2xx status within 10 seconds.

Test and monitor

  1. Click Manage on an endpoint.
  2. Click Send test event. It appears in the Delivery log.
  3. Each delivery shows its status (Pending, Delivered, Failed or Dropped), its attempts and the response.
  4. Click Replay to send a delivery again with the same event id.

Failed deliveries are retried up to 8 times over about 42 hours. An endpoint that fails for 3 days in a row is disabled; fix it and click Re-enable.

Other actions

  • Pause and Resume deliveries.
  • Rotate secret: during the Overlap (hours) every delivery is signed with both secrets.
  • Delete: no new events are sent; the delivery log is kept for audit.

What can block you

  • Only owners and admins can manage webhooks.
  • Internal, local and private addresses are refused.
  • Test events and replays need an active endpoint.
  • In MOCK mode nothing is sent over the network; deliveries are simulated.

Messages you may see

  • "A public https:// URL on port 443. Internal, local and private addresses are refused."
  • "Disabled after failing for 3 days in a row"
  • "Test events and replays need an active endpoint. Resume it first."

More in Developers