Webhooks · POST
Register webhook
POST /webhooks/register
About
Register webhook is a POST endpoint in the Webhooks group of the Spotify Data API. The spec declares no query or path parameters for it. It takes a required JSON request body with 2 fields: url (string) and events (array of string). No recorded sample exists for it; press Run to fetch a live response.
Parameters
No parameters
The spec declares no query or path parameters for this endpoint; it takes a JSON request body instead.
Request body application/json Required
- url Optional
- Type
- string
- events Optional
- Type
- array of string
Request
Against https://spotify-proxy.checkleaked.cc, with the same example values the Run button sends. No verified example value exists for a request body, so the example leaves it out and the Run dialog asks for it first.
| curl -X POST \ |
| "https://spotify-proxy.checkleaked.cc/webhooks/register" \ |
| -H "x-api-key: $SPOTIFY_API_KEY" \ |
| -H "Content-Type: application/json" \ |
| -d '{}' |
Sample response
Live only
This endpoint has no recorded sample. Press Run to fetch a real response.
Errors
- 400
- A JSON request body is required. The spec marks no single field mandatory, but an empty body is rejected: send “url” and “events” with values of the declared type, and Content-Type: application/json.
- 401 / 403
- The key is missing, wrong, or on a plan that does not include this endpoint. On RapidAPI the header is X-RapidAPI-Key; on the Direct Portal it is an Authorization: Bearer token; on Apify the actor supplies it.
- 429
- Rate limited. The demo on this site allows 100 requests per 15 minutes and 500 per day per visitor, inside a budget shared by every visitor. With a key it is 5 requests per second on every RapidAPI plan and 10 per second on the Direct Portal.
- 5xx
- Spotify itself failed or timed out. These are transient; retry once with a short backoff rather than immediately.
Related endpoints
The other 5 operations in the Webhooks group.