Webhooks

Register a webhook

Register a webhook URL to receive push-delivered signal events instead of polling /feed. Subscribe to event types (new_follow, convergence) with optional filters (e.g. sector); provide secret to get signed deliveries. Up to 10 active webhooks per API key (400 when the limit is reached). Costs 40 credits to register, then 8 credits per delivered event. Failed deliveries are retried up to 5 times with increasing backoff.

post/webhooks

Request

  • Base URL: https://frontrun.vc/v1
  • URL: https://frontrun.vc/v1/webhooks
  • Auth: API key in header X-API-Key

Request body

urlstring uri required

HTTPS endpoint to receive event POSTs.

eventsstring[] required

Event types to subscribe to (e.g. "new_follow", "convergence").

filtersobject

Optional event filters (e.g. sector).

secretstring

Optional signing secret for verifying deliveries.

Response

Webhook registered.

idstring
urlstring
eventsstring[]
filtersobject
statusstring
created_atstring date-time
cost_creditsinteger

Credits charged for this call.

balance_creditsinteger

Remaining credit balance after this call.

Changes

No recorded changes to this operation across all 2 revisions of this API.