Webhooks

Handle incoming webhook

Trigger a tool execution from an external webhook (Stripe, GitHub, etc.).

The request body becomes the tool's input payload. Returns 202 Accepted immediately and executes the tool asynchronously.

Also handles webhook challenge/verification patterns inline:

  • monday.com, Slack: POST body { challenge: "..." } → echoes challenge as JSON
  • Generic: POST body { verification_token: "...", type: "verification" } → echoes token as JSON

superglue authenticates access to this endpoint, but does not validate provider-specific HMAC signatures in the incoming payload.

post/hooks/{toolId}

Request

  • Base URL
    https://api.superglue.cloud/v1
  • Auth
    • HTTP bearer
    • or API key in query parameter token

Path parameters

toolIdstring required

ID of the tool to trigger

Request body

object required

Example request

{
  "id": "evt_1234",
  "type": "customer.created",
  "data": {
    "object": {
      "id": "cus_abc123",
      "email": "user@example.com"
    }
  }
}

Response

Challenge response returned for supported POST verification payloads

object required

Changes

No recorded changes to this operation across all 1 revision of this API.