Modern Web / Webhooks
Publish articles to any CMS or platform via webhook URL.
Overview
The Webhooks integration is designed for any CMS or web platform that is not WordPress, Shopify, or Wix. By configuring a webhook URL, you can receive article data from Rankfender via HTTP POST requests and process it in your own system.
How It Works
When an article is published from Rankfender with the Webhooks integration active, Rankfender sends an HTTP POST request to your configured webhook endpoint. Your server receives the request, processes the article data, and creates the content in your CMS or platform.
Article Payload
| Field | Type | Description |
|---|---|---|
| title | string | The article title. |
| content | string (HTML) | The full article content as HTML markup. |
| meta_description | string | The SEO meta description for the article. |
| featured_image_url | string (URL) | The URL of the article's featured image. |
| keywords | array of strings | The target keywords associated with the article. |
| publish_date | string (ISO 8601) | The intended publish date for the article. |
Setup
- Enter your webhook endpoint URL — Navigate to Project Settings > Integrations > Webhooks and enter the full URL of your webhook endpoint.
- Add custom headers (optional) — Add custom authentication headers if required by your endpoint.
- Test the connection — Click Test Connection to send a test payload. A 2xx response indicates success.
Supported Platforms
- Next.js — Create an API route that receives the webhook and creates content in your data layer.
- Gatsby — Use a serverless function or a content management backend that triggers Gatsby rebuilds.
- Hugo — Set up a server-side handler that writes markdown files and triggers site rebuilds.
- Custom CMS — Build a webhook receiver that maps the article payload to your CMS's content model.
- Headless CMS platforms — Route webhook data through a middleware layer to platforms like Contentful, Sanity, or Strapi.
Managing the Integration
- Active/Inactive Toggle — Toggle the integration on or off. The endpoint configuration is preserved when inactive.
- Update Endpoint — Change the webhook URL or custom headers at any time.
- Test Connection — Re-test the connection after making changes.