Webhooks

Set up webhooks to receive notifications when cards hit price thresholds.

Create a Webhook

POST /v1/webhooks

Authentication: Session cookie (Pro tier)

Request Body:

{
  "url": "https://your-app.com/webhook",
  "card_id": 12345,
  "condition": "below",
  "threshold": 20.00
}

Field	Type	Description
`url`	string	Your webhook endpoint URL
`card_id`	integer	Card to monitor
`condition`	string	`above` or `below`
`threshold`	number	Price threshold in USD

Webhook Payload

When triggered, we’ll send a POST to your URL:

{
  "event": "price_alert",
  "card_id": 12345,
  "card_name": "Charizard ex",
  "condition": "below",
  "threshold": 20.00,
  "current_price": 18.75,
  "timestamp": "2026-02-19T07:00:00.000Z"
}

Managing Webhooks

# List your webhooks
curl "https://api.tcgapi.dev/v1/webhooks" \
  -H "Cookie: session=YOUR_SESSION"

# Delete a webhook
curl -X DELETE "https://api.tcgapi.dev/v1/webhooks/WEBHOOK_ID" \
  -H "Cookie: session=YOUR_SESSION"