Custom API · Developers

How to Connect a Custom Webhook to Writelio

Send each published article to your own endpoint as JSON.

Use the Webhook integration to publish to anything. Writelio POSTs each article to your endpoint as JSON, so you can push content into a headless CMS, a Next.js blog, a static-site repo, Zapier/Make, or any custom app. Connection is just your endpoint URL.

Before you start

What you’ll need from Webhook

Webhook URLYour endpoint, e.g. https://your-app.com/api/incoming. Writelio sends a JSON POST here on publish.

Connect Webhook in 4 steps

1
Build an endpoint

Create an HTTPS endpoint (a serverless function, API route, or automation webhook) that accepts a POST with a JSON body and returns a 200.

2
Add the connection in Writelio

In Integrations, open the Webhook card → Configure, paste your Webhook URL, and click Save.

3
Test the connection

In the editor, open Share & Publish → Webhook and click Test to send a sample payload and confirm your endpoint responds.

4
Publish

Click Publish. Writelio POSTs the article JSON to your URL; your code decides what to do with it (store it, commit it, forward it).

What gets published

Writelio sends a JSON POST containing:

This is the most flexible integration — anything that can receive a webhook can publish from Writelio.

Troubleshooting

Test fails or times out
Confirm your endpoint is publicly reachable over HTTPS, accepts POST (not just GET), and responds quickly with a 2xx status.
Receiving the data but content looks escaped
Parse the request body as JSON. The content field is an HTML string — render or store it as HTML on your side.
Nothing arrives
Check the URL has no typo, your function is deployed (not local-only), and your firewall/auth does not block external POSTs.

Frequently asked questions

Can I use this with Zapier or Make?
Yes — create a “Catch Hook” / webhook trigger, paste its URL into Writelio, and route the article anywhere those tools support.
Is it good for a Next.js or headless blog?
Ideal — receive the JSON in an API route and write it to your database, MDX files, or headless CMS.
What format is the content?
Clean HTML in the content field, plus a slug and metadata. Convert to Markdown on your side if you prefer.

More integration guides