Webhook-Delivery

Schedule a new webhook (UI-driven)

POST /scheduled

Schedule a webhook delivery for a future time and optional recurrence. This endpoint is typically called from the UI and expects form data.

application/x-www-form-urlencoded

Body Required

  • subscription_id string(uuid) Required

    ID of the subscription for this scheduled webhook.

  • payload string Required

    The JSON payload to be delivered.

  • scheduled_for string Required

    The specific time the webhook is scheduled for (e.g., YYYY-MM-DDTHH:MM).

  • recurrence string Required

    How often the webhook should recur.

    Values are none, daily, weekly, or monthly. Default value is none.

Responses

  • 302

    Scheduled webhook creation initiated, redirecting to UI.

    Hide headers attribute Show headers attribute
    • Location string(uri)

      URL to the subscription's UI page or scheduled tasks list.

  • 400 application/json

    The request was malformed or invalid.

    Hide response attribute Show response attribute object
    • error string
  • 500 application/json

    An unexpected error occurred on the server.

    Hide response attribute Show response attribute object
    • error string
POST /scheduled 
curl \
 --request POST 'http://localhost:8080/scheduled' \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'subscription_id=string&payload=string&scheduled_for=string&recurrence=none'
Response examples (400) 
{
  "error": "string"
}
Response examples (500) 
{
  "error": "string"
}