Skip to main content

Webhook Integration

Use webhooks when you want Jottler to notify external automation tools whenever an article is published.

Setup flow

  1. Create a webhook URL in your automation platform:
    • Make
    • Zapier
    • n8n
    • any endpoint that accepts JSON POST payloads
  2. In Jottler, go to:
    • Settings -> Integrations -> Webhook
  3. Paste your webhook URL and save.
  4. Send a test payload from Jottler to confirm your receiver mapping.

Event payload example

{
"event": "article.published",
"timestamp": "2026-03-14T12:00:00Z",
"article": {
"id": "uuid",
"title": "Article Title",
"slug": "article-title",
"html": "<p>Full HTML content</p>",
"metaDescription": "SEO meta description",
"keywords": ["keyword1", "keyword2"],
"featuredImage": "https://...url or null",
"wordCount": 1500,
"createdAt": "2026-03-14T...",
"updatedAt": "2026-03-14T..."
},
"category": { "name": "Category Name" },
"topic": { "title": "Topic Title", "type": "how-to" },
"site": { "domain": "example.com", "url": "https://example.com" }
}

Testing checklist

  1. Trigger a test payload from Jottler.
  2. Verify your endpoint receives HTTP 200.
  3. Confirm field mapping in your automation step.
  4. Publish one real article and verify production handling.

Common tips

  • Keep your receiver idempotent by checking article.id.
  • Log raw payloads while building your first automation.
  • If your platform requires auth, use a webhook endpoint that supports a secret token or signed requests.