API reference

Webhooks

Receive a callback when a conversion settles, instead of polling.

Manage endpoints

GEThttps://api.markitdown.ai/webhooksList webhook endpoints

POSThttps://api.markitdown.ai/webhooksRegister an endpoint (signing secret shown once)

DELETEhttps://api.markitdown.ai/webhooks/{id}Delete an endpoint

Create body

`url`required	string (https)	Public HTTPS endpoint to receive events.
`eventTypes`required	string[]	One or more of: job.completed, job.failed.

Supported events: job.completed and job.failed. On delivery, fetch the job result with the API to get the Markdown.

The signing secret is returned once when you create the endpoint. Verify the signature header on each delivery before trusting the payload.