POST/webhooks

Register webhook

Subscribe URL to events. Patterns: `*` (all), `users.*`, `*.created`, `users.created`. Deliveries are simulated (logged, not sent).

ReturnsWebhook

AcceptsWebhookInput

Bearer token required

Response examples

201Registered

application/json example derived from schema

{
  "id": 1,
  "url": "https://example.com/webhooks/receiver",
  "events": [
    "users.created",
    "orders.*"
  ]
}

400400 — invalid input or malformed JSON

application/json

{
  "error": {
    "status": 400,
    "message": "Request body required"
  }
}

Try ItMock API v2.0.1

Code examples

curl -X POST -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' -d '{
  "url": "https://example.com",
  "events": [
    "string"
  ]
}' 'https://api.rodin.dev/mock/webhooks'

fetch("https://api.rodin.dev/mock/webhooks", {
  method: "POST",
  headers: {
      "Authorization": "Bearer <TOKEN>",
      "Content-Type": "application/json"
    },
  body: "{\n  \"url\": \"https://example.com\",\n  \"events\": [\n    \"string\"\n  ]\n}",
})
  .then((response) => response.json())
  .then((data) => console.log(data))

import requests

url = "https://api.rodin.dev/mock/webhooks"
headers = {
    "Authorization": "Bearer <TOKEN>",
    "Content-Type": "application/json"
}
data = "{\n  \"url\": \"https://example.com\",\n  \"events\": [\n    \"string\"\n  ]\n}"

response = requests.post(url, headers=headers, data=data)
print(response.json())

Authentication

Authentication

Bearer token

Paste cURL

Server:

https://api.rodin.dev/mockhttp://localhost:3002

Body:

{ "url": "https://example.com", "events": [ "string" ] }