Connect your website and let Rankonpilot send a new article every day

HTTP headers

Example payload

{
  "event": "article.publish",
  "status": "published",
  "sentAt": "2026-05-16T21:00:00.000Z",
  "website": {
    "url": "https://example.com"
  },
  "article": {
    "id": "cmp8k780l00019w490v1213q3",
    "title": "How to Improve B2B SaaS Onboarding Conversion",
    "slug": "how-to-improve-b2b-saas-onboarding-conversion",
    "metaDescription": "A practical guide to improving onboarding conversion.",
    "body": "<h2>...</h2><p>...</p>",
    "faq": [],
    "headings": [{ "level": 2, "text": "Why onboarding conversion matters" }],
    "keywords": ["b2b saas onboarding conversion"],
    "featuredImage": "https://res.cloudinary.com/...png",
    "wordCount": 1287,
    "readingTime": 6
  }
}

Example Next.js receiver

This example checks the HMAC signature with a timing-safe comparison and returns an external URL that Rankonpilot can store on the article record.

import crypto from "node:crypto";
import { NextRequest, NextResponse } from "next/server";

function signatureMatches(secret: string, rawBody: string, signature: string) {
  const expected = crypto.createHmac("sha256", secret).update(rawBody).digest();
  const received = Buffer.from(signature, "hex");
  return received.length === expected.length && crypto.timingSafeEqual(received, expected);
}

export async function POST(req: NextRequest) {
  const rawBody = await req.text();
  const signature = req.headers.get("x-rankonpilot-signature") ?? "";
  const secret = process.env.RANKONPILOT_SIGNING_SECRET ?? "";

  if (!secret || !signatureMatches(secret, rawBody, signature)) {
    return NextResponse.json({ error: "invalid signature" }, { status: 401 });
  }

  const payload = JSON.parse(rawBody);

  // Create the post, or update it if this article id was sent before.
  // payload.status is "published" (auto-publish or the Publish button)
  // or "draft" (test payloads).
  // Fields you usually store:
  // payload.article.id
  // payload.article.title
  // payload.article.slug
  // payload.article.metaDescription
  // payload.article.body
  // payload.article.featuredImage

  return NextResponse.json({ ok: true, externalUrl: "https://example.com/blog/" + payload.article.slug });
}