Webhook Integration

When your site runs on something without a native integration (a custom CMS, a static site pipeline, an internal tool), the Custom Webhook integration turns any HTTPS endpoint into a publishing destination. Every finished article is delivered as a JSON POST, ready for Zapier, Make.com, or code you wrote yourself.

A Real Integration, Not Just a URL

Built for Production Endpoints

Simple Setup, Verified Before It Matters

1. Add a Custom Webhook under Account → Integrations with your endpoint URL (a Zapier or Make.com webhook URL works as is) and an optional signing secret
2. Click Send test to deliver a sample payload and inspect the exact request headers and your endpoint's response, before any real article depends on it
3. Link the integration to a brand, and finished articles flow to your endpoint automatically

What Gets Sent

Every completed article is delivered as a single JSON POST to your endpoint:

POST <your endpoint>
Content-Type: application/json
X-Koala-Event: article.completed
X-Koala-Delivery-Id: <uuid>            (same value on every retry)
X-Koala-Signature: sha256=<hex HMAC>   (only when a signing secret is set)

{
  "id": "1b2c3d4e-...",
  "config": { "targetKeyword": "target keyword", "...": "the full article settings" },
  "output": {
    "html": "<h1>The Article Title</h1><p>Full article HTML...</p>",
    "polishedHtml": "<h1>...</h1>... or null when polish did not run"
  }
}

This is the same body a per-folder Webhook URL sends, so a single endpoint handles both and you can switch between them freely.

Technical Details

• HTTP POST with a JSON payload: article id, the article settings, and both the raw and polished article HTML
• Event headers: X-Koala-Event identifies the delivery type, and X-Koala-Signature carries the HMAC when a secret is set
• Clear success semantics: any 2xx response counts as published; anything else is recorded against the article so you can see exactly what your endpoint returned
• Verification code included: the API docs include a copy-paste signature verification example

Note: a plain per-folder Webhook URL (set on the folder in your Library) and the bulk-writer webhookUrl parameter both still work, and send the same payload shown above. The Custom Webhook integration adds signing, automatic retries, a stable IP, test sends, and reuse across folders and brands.

Perfect For

Ready to publish anywhere? Try KoalaWriter and connect your endpoint in a couple of minutes.