Webhooks

Manage webhooks (Enterprise) (Enterprise)

Enterprise-only webhook CRUD on /webhooks. GET lists the API key's webhooks; POST creates a webhook (HTTPS URL + events) returning a one-time signing secret; DELETE (with ?id=) removes one. Max 10 webhooks per key. Valid events: match_completed, match_started, goal_scored.

Plan: Enterprise plan only.

post/webhooks

Request

  • Base URL: https://footballdata.io/api/v1
  • URL: https://footballdata.io/api/v1/webhooks
  • Auth: HTTP bearer

Query parameters

idinteger

Webhook ID to delete. Required for DELETE requests (errors 400 missing_id if absent or <=0). Ignored for GET/POST.

Response

Successful response

successboolean
metaMeta

Request metadata: usage counters, plan access, and pagination when applicable.

Example response

{
  "success": true
}

Changes

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