Target Webhook Connectivity Guide

Learn how to securely route AI-generated payloads from your BrandedClaws Content Studio directly into any external CMS, Node.js App, Webflow, Shopify, or Custom React application.

1. The Payload Anatomy

Whenever an article is manually Forced Published or triggered via the Temporal Scheduler inside the Content Studio, our Master Engine mathematically fires a standard `HTTP POST` request strictly packaged with a JSON object.

Example JSON Payload Output:

{
  "title": "Unlocking the Power of Enterprise Omnichannel Routing",
  "markdown_content": "# Unlocking the Power... \n\nThis is the raw syntactical content...",
  "rendered_hero_image_id": "11244585093_image_uuid_hash"
}

Security Protocol Warning: We send the JSON unconditionally to the endpoint specified. Your target application must securely accept application/json payloads and systematically sanitize the incoming markdown_content before rendering it to the public DOM.

2. Platform Integration Methods

Custom Node.js / Next.js / React Sites

The most straightforward implementation. Simply create an API route to dynamically catch the payload.

// Next.js Route Handler Example (app/api/webhook/route.ts)
import { NextResponse } from 'next/server';

export async function POST(req: Request) {
  const { title, markdown_content } = await req.json();
  
  // Custom logic to save to Prisma, MongoDB, or Postgres
  await myDatabase.post.create({
    data: { title, content: markdown_content, status: 'PUBLISHED' }
  });

  return NextResponse.json({ success: true });
}

Webflow CMS

Webflow natively supports incoming Webhooks but expects strict JSON mapping. We highly recommend using an invisible intermediary like Make.com or Zapier.

Create a new Make.com Scenario and place a Custom Webhook as the trigger.
Copy the Make.com Webhook URL and paste it into our Target Deployment URL field.
Add a Webflow "Create an Item" node in Make.com.
Map the incoming title to Webflow's Title field, and map markdown_content to Webflow's Rich Text field (Make.com automatically converts Markdown to HTML for Webflow).

Ghost CMS API

Ghost CMS requires JWT Authentication, which means you cannot directly paste a Ghost API URL into our dashboard.

You must run the payload through an authentication proxy.
The Fix: Use N8N or Zapier to catch our webhook natively, append your Ghost API Key headers, and forward the payload natively to your Ghost server.

Shopify Blogs

Similar to Ghost, Shopify requires Bearer Tokens for their Blog Endpoint.

Create a Custom App in Shopify to get a Storefront/Admin API access token.
Use an automation tool (Zapier/Make/N8N) to catch the BrandedClaws URL, convert the Markdown array into native generic HTML, and POST it securely to /admin/api/2023-10/blogs/BLOG_ID/articles.json.

Return to Content Studio