Reference

Webhook Contract

When an article is approved or auto-published, InkieAI sends a POST request to your configured webhook URL with a JSON payload. The payload includes the article title, markdown content, rendered HTML, featured image URL, meta title, meta description, canonical URL, tags array, and a Unix timestamp of when the article was generated. All requests include an X-InkieAI-Signature header for HMAC-SHA256 verification using your site-specific webhook secret.

Your endpoint must return a 2xx status code within 10 seconds. Timeouts and 4xx/5xx responses trigger an automatic retry with exponential backoff: 30 seconds, 5 minutes, 15 minutes, then failure. Failed webhooks are logged in the Run Logs panel with the full request and response bodies for debugging.

Example curl request:

curl -X POST https://your-domain.com/webhook/inkieai \
  -H "Content-Type: application/json" \
  -H "X-InkieAI-Signature: sha256=<signature>" \
  -d '{
    "title": "Kubernetes Security Best Practices for 2026",
    "slug": "kubernetes-security-best-practices-2026",
    "content": "# Kubernetes Security...",
    "html": "<h1>Kubernetes Security...</h1>",
    "featuredImage": "https://cdn.inkieai.com/img/abc123.jpg",
    "meta": {
      "title": "Kubernetes Security Best Practices for 2026 | YourBrand",
      "description": "A practical guide to securing Kubernetes clusters..."
    },
    "tags": ["kubernetes", "security", "devops"],
    "generatedAt": 1716268800
  }'