Webhooks

Register a webhook

Register an HTTPS endpoint to receive signed POSTs when matching alpha signals are emitted. Defaults: events=["alpha_signals"], min_impact="MEDIUM". Outbound payloads are HMAC-SHA256 signed with the per-webhook secret returned at creation; verify the X-MarketIntell-Signature header server-side. Pro tier or higher required.

post/v1/webhooks

Request

  • Base URL: https://api.marketintell.ai
  • URL: https://api.marketintell.ai/v1/webhooks
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

urlstring uri required

HTTPS webhook URL

eventsstring[]
min_impact'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL'

Response

Webhook created. The secret is returned exactly once — store it now or rotate.

idstring required
urlstring uri required
eventsstring[] required
secretstring required

HMAC-SHA256 signing secret (shown once)

min_impact'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL'
created_atstring date-time

Changes

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