When an article is published, updated or pulled, Bloge sends a JSON payload to your URL. Signed with HMAC SHA256, so you know it came from us.
Endpoint URL and an optional signing secret · Free plan · No credit card
POST /hooks/blogeContent-Type: application/jsonX-Bloge-Signature: sha256=7f3a91…c4e2 { "event": "blog.published", "blog": { "title": "Light vs dark roast", "slug": "light-vs-dark-roast", "tags": ["roasting", "brewing"] }, "timestamp": "2026-10-14T09:00:12Z"}
| Field | Contains |
|---|---|
| event | blog.published, blog.updated or blog.unpublished |
| blog.title | Article title |
| blog.slug | URL slug |
| blog.html_body | Article body as HTML |
| blog.excerpt | Summary |
| blog.cover_url | Cover image URL |
| blog.canonical_url | Canonical URL |
| blog.tags | Topic tags |
| X-Bloge-Signature | sha256= HMAC of the raw body |
Endpoint URL
Step 1
Give Bloge a URL that accepts POST requests with a JSON body.
Signing secret
X-Bloge-Signature: sha256=…
Step 2
Optional, and recommended. Bloge signs every request so you can reject anything else.
Step 3
Bloge posts a connection.test event. Return any 2xx status and you are live.
Something else on your mind? Write to us at [email protected].
Compute an HMAC SHA256 of the raw request body with your secret, prefix it with sha256= and compare it to the X-Bloge-Signature header using a constant time comparison.