Webhooks

Send generated content to any external system via HTTP webhooks.

Overview

Webhooks allow you to automatically send generated articles to any external system that can receive HTTP POST requests. This is useful for:

Custom CMS integrations
Automation workflows (Zapier, Make, n8n)
Internal publishing systems
Content distribution platforms

Setting Up Webhooks

Go to Settings in your dashboard
Select the domain you want to configure
Scroll to the Integrations section
Enable the Webhook integration
Enter your webhook endpoint URL
Click Save

info Webhook URL Requirements

Your webhook URL must be a valid HTTPS endpoint that accepts POST requests and returns a 2xx status code on success.

Webhook Payload

When content is generated, Content Zen sends a POST request with the following form data payload:

Field	Type	Description
`title`	string	The generated article title
`description`	string	Meta description for the article
`content`	string	Full HTML content of the article
`ai_image_urls`	string	Semicolon-separated list of AI-generated image URLs (if any)

Example Payload

title=How to Improve Your SEO Strategy
description=Learn the top 10 SEO techniques that will boost your website rankings in 2024.
content=<h2>Introduction</h2><p>Search engine optimization...</p>
ai_image_urls=https://example.com/image1.jpg;https://example.com/image2.jpg

Expected Response

Your webhook endpoint should return a 2xx status code to indicate successful receipt. Optionally, you can return a JSON response with a url field containing the published article URL:

{
  "url": "https://yourblog.com/articles/how-to-improve-seo"
}

If provided, this URL will be stored and displayed in the Content Zen dashboard for easy access to the published article.

Error Handling

If your webhook endpoint returns a non-2xx status code or is unreachable, the webhook delivery will be marked as failed. You can view failed webhook attempts in the Log section of your dashboard.

warning No Automatic Retries

Currently, failed webhooks are not automatically retried. Ensure your endpoint is reliable and returns appropriate status codes.

Testing Your Webhook

Before using webhooks in production, we recommend testing with a service like:

webhook.site - Free webhook testing service
RequestBin - Inspect webhook payloads

These services provide temporary URLs that let you inspect incoming webhook requests and verify the payload format.