Skip to main content
POST
Create Webhook

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
url
string<uri>
required

Public HTTPS URL where webhook events will be delivered.

events
enum<string>[]
required

List of events the consumer wants to subscribe to.

Minimum array length: 1
Available options:
tournament.created,
tournament.backfilled,
tournament.updated,
tournament.deleted,
match.created,
match.backfilled,
match.updated,
match.deleted,
match.qualy.created,
match.qualy.backfilled,
match.qualy.updated,
match.qualy.deleted,
player.created,
player.updated,
player.deleted

Response

WebhookResource

id
integer
required

Unique identifier of the webhook subscription. Use it to update or delete the subscription.

self
string
required

Path to this webhook's endpoint, relative to https://padelapi.org.

url
string
required

HTTPS endpoint that receives the event payloads.

events
any[]
required

Events this subscription is listening to. An empty array pauses delivery without deleting the subscription.

secret
string
required

Key used to verify the HMAC signature on incoming payloads, so you can confirm a request really came from us. Returned in full only in the response that creates the webhook: every later response returns it masked, so store it securely at creation time. See the Webhooks guide for the verification flow.

created_at
string
required

ISO 8601 timestamp of when the subscription was created.

updated_at
string
required

ISO 8601 timestamp of the last change to the URL or the event list.