---
title: "For Developers: Webhooks, Integrations and Publishing – Probeli AI"
description: "How Probeli AI delivers articles to any site: native integrations, a signed webhook with retries, or a blog we set up on your domain."
url: "https://probeli.ai/developers"
---

For developers

# Your articles, *on any site.*

Probeli AI writes your articles and publishes them on their dates. *A native integration posts them to your platform. Or Probeli AI sends each one to your endpoint, signed. Then you show them on any site you built, in your own design.*

- Native we post to your platform
- Push we send to your endpoint
- No blog we set one up on your domain

[Writing your own receiver? The webhook reference lists every header, field and retry, with an example. Open the reference](https://probeli.ai/integrations/webhook)

## Overview

Each article has a title, a body in HTML and Markdown, a cover image, SEO fields and tags. Once your site is connected, every new article arrives by itself. Nobody on your team writes or pastes anything.

## Which way fits your site

- Native
  ### Integrations
  WordPress, WordPress.com, Shopify, Webflow and Wix. Probeli AI posts each article as a normal post, at a normal address. There is nothing to build.
- Push
  ### Webhook
  Probeli AI sends each article to an https endpoint you own, signed with your secret. Your side never has to ask. The article reaches your database when it publishes.
- No blog
  ### Blog set up for you
  No blog yet? We set one up for you on your own domain. Then Probeli AI publishes there like any connected site.

## Webhook */ push*

Get each article at an endpoint you own, instead of asking for it. Add your https address in **Settings › Publishing**. Probeli AI sends a signed ping first, and saves the webhook once your endpoint accepts it. You get a signing secret to check every request.

```
POST https://example.com/hooks/probeli
```

Request headers

```
Probeli-Signature: t=1760605200,v1=6b1f0c9e2a…
Probeli-Event: article.published
Probeli-Delivery: 5d0c2f7e-3b8a-4f4e-9a51-2c6f0e8d7b13
Probeli-Timestamp: 1760605200
Content-Type: application/json; charset=utf-8
```

The body is JSON: the event, its time and the article in `data.article`. Every field is in [the webhook reference](https://probeli.ai/integrations/webhook).

## Fields

The fields of one article in the webhook's data.article. The full payload is in [the webhook reference](https://probeli.ai/integrations/webhook).

| Field | Type | Notes |
| --- | --- | --- |
| `title` | string | Show it as your page's only h1. |
| `slug` | string | Stable for each article. Store your pages by it. |
| `html` | string (HTML) | The body, ready to show. It has no h1. |
| `markdown` | string | The same body in Markdown. |
| `metaTitle`, `metaDescription` | string or null | For your title tag and meta description. |
| `coverImage` | object or null | The cover's `url` and `alt`. |
| `excerpt` | string or null | A short summary for cards and lists. |
| `tags` | array | Your tags for the article. |
| `publishedAt`, `modifiedAt` | ISO 8601 | Save the article again on `article.updated`. |

## Check a delivery

v1 in Probeli-Signature is the hex HMAC-SHA256 of t, a dot and the raw body, keyed with your secret. Compute it over the raw body, before any JSON parser runs (in Express, express.raw()). Compare it in constant time. Refuse a t older than 5 minutes, so an old request can't be sent again.

verify.js Node.js

```
import { createHmac, timingSafeEqual } from "node:crypto";

export function isFromProbeli(rawBody, header, secret) {
const parts = Object.fromEntries(header.split(",").map((part) => part.split("=")));
const age = Math.abs(Date.now() / 1000 - Number(parts.t));
if (!parts.t || !parts.v1 || age > 300) return false;
const expected = createHmac("sha256", secret)
.update(parts.t + "." + rawBody)
.digest("hex");
const given = Buffer.from(parts.v1, "hex");
const wanted = Buffer.from(expected, "hex");
return given.length === wanted.length && timingSafeEqual(given, wanted);
}
```

verify.py Python

```
import hashlib, hmac, time

def is_from_probeli(raw_body: bytes, header: str, secret: str) -> bool:
parts = dict(part.split("=", 1) for part in header.split(","))
if "t" not in parts or "v1" not in parts or abs(time.time() - int(parts["t"])) > 300:
return False
signed = parts["t"].encode() + b"." + raw_body
expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, parts["v1"])
```

verify.php PHP

```
<?php
function is_from_probeli(string $rawBody, string $header, string $secret): bool {
parse_str(str_replace(',', '&', $header), $parts);
if (!isset($parts['t'], $parts['v1']) || abs(time() - (int) $parts['t']) > 300) {
return false;
}
$expected = hash_hmac('sha256', $parts['t'] . '.' . $rawBody, $secret);
return hash_equals($expected, $parts['v1']);
}
```

## Delivery and retries

- **Sent on every publish.** article.published the first time an article goes live, article.updated after that.
- **Tried again on failure.** A network error, 408, 429 or 5xx gets up to 3 tries in all.
- **Answer with any 2xx.** We wait 10 seconds. Store by data.article.id, so a repeat makes one page.
- **Any public https address.** It must use port 443, and Probeli AI never follows a redirect.

## No blog yet?

Don't want to build anything? We set up a blog for you on your own domain. Then Probeli AI publishes your articles there, like on any other connected site. [Talk to us](https://probeli.ai/contact).

## Notes

- **Published articles only.** The webhook carries articles that are being published. No drafts and no account data.
- **Your articles are yours.** Keep them, export them and host them where you like.
- **Your answer sets the address.** Return url and id with your 2xx, and Probeli AI links to your page.
- **Questions?** [Write to us](https://probeli.ai/contact), and we'll help you connect your site.
