Webhooks Overview

{
  "message": "Processed release event (published)",
  "event": "release",
  "delivery": "12345678-1234-1234-1234-123456789abc",
  "processed": {
    "type": "release",
    "action": "published",
    "data": { "tagName": "v1.2.0", "name": "Version 1.2.0", "body": "...", "prerelease": false, "draft": false, "publishedAt": "2026-09-01T14:30:00Z", "url": "https://github.com/owner/repo/releases/tag/v1.2.0" }
  },
  "repository": { "id": 123456, "fullName": "owner/repo" }
}

{
  "message": "Pong! Webhook configured successfully",
  "event": "ping",
  "delivery": "12345678-1234-1234-1234-123456789abc"
}

{
  "message": "Event 'push' with action '' was filtered out",
  "event": "push",
  "action": "",
  "filtered": true
}

{
  "message": "Event type 'issues' is not supported",
  "event": "issues",
  "ignored": true
}

{
  "message": "Webhook already processed (duplicate delivery)",
  "event": "push",
  "delivery": "12345678-1234-1234-1234-123456789abc",
  "duplicate": true
}

{ "error": "Invalid webhook signature" }

{ "error": "Integration is disabled" }

{ "error": "Missing X-GitHub-Event header" }

{ "error": "Webhook secret not configured for this repository" }

JOB_ID=$(curl -s https://api.usenotra.com/v1/posts/generate \
  -H "Authorization: Bearer $NOTRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contentType":"changelog","lookbackWindow":"last_7_days"}' | jq -r '.job.id')

until curl -s "https://api.usenotra.com/v1/posts/generate/$JOB_ID" \
  -H "Authorization: Bearer $NOTRA_API_KEY" \
  | jq -e '.job.status | IN("completed","failed","skipped")' > /dev/null; do
  sleep 10
done

const headers = { Authorization: `Bearer ${process.env.NOTRA_API_KEY}` };

const queued = await fetch("https://api.usenotra.com/v1/posts/generate", {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ contentType: "changelog", lookbackWindow: "last_7_days" }),
}).then((res) => res.json());

const jobId: string = queued.job.id;
const terminal = new Set(["completed", "failed", "skipped"]);

let job = queued.job;
while (!terminal.has(job.status)) {
  await new Promise((resolve) => setTimeout(resolve, 10_000));
  const status = await fetch(`https://api.usenotra.com/v1/posts/generate/${jobId}`, { headers })
    .then((res) => res.json());
  job = status.job;
}

if (job.status === "completed") {
  const { post } = await fetch(`https://api.usenotra.com/v1/posts/${job.postId}`, { headers })
    .then((res) => res.json());
  console.log(post.title);
}