Webhook / API Integration
Universal integration for any platform using webhooks and REST API
How Webhook Integration Works
Set Up Your Endpoint
Create an endpoint on your server that can receive POST requests with blog content. BlogBotz will send the generated blog data to this URL.
Configure in BlogBotz
Add your webhook URL in BlogBotz dashboard > Sites > Add Site > Custom API. BlogBotz will automatically generate a webhook secret for HMAC-SHA256 signature verification.
Receive & Process
When you publish a blog, BlogBotz sends a POST request with the full blog content. Your server processes it and publishes to your platform.
Request Headers
Every webhook request includes these headers for security and identification:
Content-Type: application/json
X-BlogBotz-Signature: sha256=<HMAC-SHA256 hash of request body>
X-BlogBotz-Event: blog.published
X-BlogBotz-Timestamp: 2024-01-15T10:30:00+00:00Verifying Signatures
To verify authenticity, compute the HMAC-SHA256 hash of the raw request body using your webhook secret, then compare it with the X-BlogBotz-Signature header value.
Publish Payload Example
When a blog is published, BlogBotz sends a POST request with this payload structure:
{
"title": "Your Blog Title",
"content": "<p>Full HTML content...</p>",
"excerpt": "Brief meta description...",
"slug": "your-blog-title",
"status": "publish",
"featured_image": "https://blogbotz.com/storage/images/...",
"featured_image_alt": "Descriptive alt text",
"tags": ["seo", "marketing", "tips"],
"meta_title": "SEO Optimized Title",
"meta_description": "SEO meta description...",
"blog_id": 123,
"blogbotz_id": 123
}Expected Response
Your endpoint should return a JSON response with the published post details:
// HTTP 200 OK
{
"post_id": "456",
"post_url": "https://yoursite.com/blog/your-blog-title"
}Response Fields
post_idorid— The ID of the created post on your platformpost_url,url, orlink— The public URL of the published post
Use Cases
Custom CMS
Integrate with your custom-built content management system.
Headless CMS
Perfect for Strapi, Contentful, Sanity, and other headless CMS platforms.
Static Sites
Trigger builds for Gatsby, Next.js, Hugo, and other static site generators.
Automation
Connect with Zapier, Make, n8n, or any automation platform.