---
title: "Content Publishing API"
description: "Create and update tool pages, articles, feature pages, and model pages via the content webhook."
updated: 2026-03-26
---

# Content Publishing API

Create SEO-optimized pages programmatically. Used by Claude Code agents and automation scripts.

## Endpoint

```
POST https://www.wireflow.ai/api/content/webhook
Authorization: Bearer YOUR_CONTENT_WEBHOOK_SECRET
Content-Type: application/json
```

The secret is the `CONTENT_WEBHOOK_SECRET` environment variable.

## Content Types

| Type      | URL Pattern        | parentCategory |
| --------- | ------------------ | -------------- |
| `TOOL`    | `/features/{slug}` | `features`     |
| `FEATURE` | `/features/{slug}` | `features`     |
| `APP`     | `/features/{slug}` | `features`     |
| `MODEL`   | `/models/{slug}`   | `models`       |
| `ARTICLE` | `/blog/{slug}`     | `articles`     |

## Create a Tool Page

```bash
curl -X POST https://www.wireflow.ai/api/content/webhook \
  -H "Authorization: Bearer $CONTENT_WEBHOOK_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "create_tool",
    "type": "TOOL",
    "slug": "ai-background-remover",
    "title": "AI Background Remover",
    "subtitle": "Remove backgrounds from any image instantly with AI",
    "meta_description": "Free AI background remover. Upload an image and get a clean cutout in seconds.",
    "seoKeywords": ["background remover", "remove background", "ai cutout"],
    "heroImage": "https://cdn.wireflow.ai/tools/bg-remover-hero.jpg",
    "c2aTitle": "Remove Backgrounds Now",
    "c2aSubtitle": "Upload an image and get results in seconds",
    "c2aButtonCopy": "Start Creating",
    "c2aLink": "/workflows",
    "isPublished": true,
    "valueProps": [
      {
        "title": "Instant Results",
        "description": "AI removes backgrounds in under 5 seconds"
      },
      {
        "title": "No Signup Required",
        "description": "Start using immediately, no account needed"
      }
    ],
    "faqSchema": [
      {
        "question": "How does the AI background remover work?",
        "answer": "Our AI model detects the subject and cleanly separates it from the background."
      }
    ],
    "howToSteps": [
      {
        "title": "Upload your image",
        "description": "Drag and drop or click to upload any image format"
      },
      {
        "title": "AI processes automatically",
        "description": "Background is detected and removed in seconds"
      },
      {
        "title": "Download your result",
        "description": "Get a transparent PNG ready for use"
      }
    ]
  }'
```

## Create an Article

```bash
curl -X POST https://www.wireflow.ai/api/content/webhook \
  -H "Authorization: Bearer $CONTENT_WEBHOOK_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "create_article",
    "type": "ARTICLE",
    "slug": "guide-to-ai-video-generation",
    "title": "Complete Guide to AI Video Generation in 2026",
    "subtitle": "Everything you need to know about creating videos with AI",
    "meta_description": "Learn how to generate professional videos using AI tools like Kling, Veo, and more.",
    "body_markdown": "# Introduction\n\nAI video generation has...",
    "seoKeywords": ["ai video generation", "kling video", "veo 3"],
    "isPublished": true
  }'
```

## Create a Model Page

```bash
curl -X POST https://www.wireflow.ai/api/content/webhook \
  -H "Authorization: Bearer $CONTENT_WEBHOOK_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "create_model",
    "type": "MODEL",
    "slug": "kling-video-3",
    "title": "Kling Video 3.0",
    "subtitle": "High-quality AI video generation with motion control",
    "meta_description": "Generate professional videos with Kling Video 3.0 AI model.",
    "seoKeywords": ["kling video", "ai video model"],
    "isPublished": true,
    "workflowId": "clx1abc123"
  }'
```

## Update Existing Content

Use `PUT` with the same endpoint. Lookup is by `slug`.

```bash
curl -X PUT https://www.wireflow.ai/api/content/webhook \
  -H "Authorization: Bearer $CONTENT_WEBHOOK_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "ai-background-remover",
    "title": "AI Background Remover - Updated",
    "isPublished": true,
    "valueProps": [
      {
        "title": "Even Faster",
        "description": "Now processes in under 2 seconds"
      }
    ]
  }'
```

## All Fields Reference

### Required (all types)

| Field   | Type   | Description                           |
| ------- | ------ | ------------------------------------- |
| `slug`  | string | URL slug (unique, lowercase, hyphens) |
| `title` | string | Page title (unique)                   |

### Content Fields

| Field           | Type    | Description                                  |
| --------------- | ------- | -------------------------------------------- |
| `subtitle`      | string  | Subtitle (defaults to title)                 |
| `type`          | enum    | `TOOL`, `FEATURE`, `APP`, `MODEL`, `ARTICLE` |
| `body_markdown` | string  | Markdown body (mainly for ARTICLE)           |
| `heroImage`     | string  | Hero image URL                               |
| `isPublished`   | boolean | Whether page is live (default: false)        |

### SEO Fields

| Field              | Type     | Description                 |
| ------------------ | -------- | --------------------------- |
| `meta_description` | string   | Meta description for search |
| `seoKeywords`      | string[] | Target keywords             |
| `canonicalUrl`     | string   | Canonical URL               |
| `ogImage`          | string   | Open Graph image            |
| `pillar`           | string   | Content pillar              |

### CTA Fields

| Field           | Type   | Description                             |
| --------------- | ------ | --------------------------------------- |
| `c2aTitle`      | string | Call to action title                    |
| `c2aSubtitle`   | string | CTA subtitle                            |
| `c2aButtonCopy` | string | Button text (default: "Start Creating") |
| `c2aLink`       | string | Button link (default: "/workflows")     |

### Rich Content Fields

| Field           | Type   | Description                                            |
| --------------- | ------ | ------------------------------------------------------ |
| `valueProps`    | array  | `[{ title, description, icon?, image? }]`              |
| `faqSchema`     | array  | `[{ question, answer }]` — generates FAQ schema markup |
| `howToSteps`    | array  | `[{ title, description, image? }]`                     |
| `contentBlocks` | array  | Generic content blocks                                 |
| `crossLinks`    | array  | `[{ url, anchorText, description? }]`                  |
| `quickAnswer`   | object | `{ question, answer, bullets?, variant? }`             |

### Linking Fields

| Field            | Type   | Description                                                        |
| ---------------- | ------ | ------------------------------------------------------------------ |
| `workflowId`     | string | Link to a Wireflow workflow                                        |
| `subcategory`    | string | Page subcategory                                                   |
| `parentCategory` | string | Auto-derived from type. Override: `features`, `articles`, `models` |

## Common Errors

| Status | Error                     | Fix                                                           |
| ------ | ------------------------- | ------------------------------------------------------------- |
| 401    | Invalid webhook secret    | Check `CONTENT_WEBHOOK_SECRET` env var                        |
| 409    | Slug already exists       | Use PUT to update, or pick a different slug                   |
| 500    | Unique constraint (title) | Each page title must be unique                                |
| 500    | No author available       | Ensure andrew@wireflow.ai or michael@wireflow.ai exists in DB |

## Workflow Preview

When a page has `workflowId` set, a lightweight workflow preview automatically renders on the page. The preview shows a simplified visual of the workflow's nodes and connections — no ReactFlow dependency, just HTML/CSS/SVG.

### How it works

- **Feature/Model pages**: The preview appears below the hero section, above the how-to steps and content blocks.
- **Blog/Article pages**: The preview appears after the article body, before the related posts section, with a "Try this workflow" heading.
- **CTA button**: Each preview includes an "Open this workflow" button that links to `/flow/{workflowId}`.

### Setting `workflowId` on a page

Include `workflowId` when creating or updating a page via the webhook:

```bash
curl -X POST https://www.wireflow.ai/api/content/webhook \
  -H "Authorization: Bearer $CONTENT_WEBHOOK_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "create_model",
    "type": "MODEL",
    "slug": "kling-video-3",
    "title": "Kling Video 3.0",
    "subtitle": "High-quality AI video generation",
    "workflowId": "clx1abc123",
    "isPublished": true
  }'
```

The `workflowId` is the CUID of any workflow in the database. The workflow data is fetched server-side at render time for optimal page speed and SEO.

### Components

Two components are available for custom integrations:

- `WorkflowPreviewServer` — Server component, fetches from Prisma directly. Best for SEO pages.
- `WorkflowPreview` — Client component, fetches from `/api/workflows/{id}/preview`. Use for interactive contexts.

```tsx
import { WorkflowPreviewServer } from '@/components/marketing/WorkflowPreviewServer';

// In a server component:
<WorkflowPreviewServer workflowId="clx1abc123" className="mt-8" />
```

## Tips for Claude Code

- Always set `isPublished: true` if you want the page live immediately
- Use `type: "TOOL"` for tool/feature pages — parentCategory is auto-derived
- Slugs should be lowercase with hyphens: `ai-background-remover`
- Include at least 3 `faqSchema` entries for better SEO
- Include at least 3 `valueProps` for the page layout to look complete
- Set `workflowId` to link the page to a specific workflow template

---

Documentation index: fetch https://www.wireflow.ai/llms.txt for the full list of Wireflow docs.