Outbound Publish Webhook

Available on Solo and Team plans.

ShipRelay can send a POST request to a URL you configure every time you publish a changelog. This enables integrations with Slack, Discord, Zapier, or any custom system.

Setup

1. Go to Repository Settings → Webhook
2. Enter your webhook URL (must be HTTPS)
3. Save

Payload

When you publish, ShipRelay sends a POST request with this JSON body:

{
  "event": "changelog.published",
  "version": "v1.2.0",
  "date": "2026-04-06T12:00:00Z",
  "summary": "Added dark mode, fixed login timeout, improved dashboard load time",
  "url": "https://shiprelay.io/your-slug/v1.2.0",
  "project": "your-slug"
}

Headers

Content-Type: application/json
User-Agent: ShipRelay-Webhook/1.0

Retry logic

If your endpoint returns a non-2xx status code or times out (30 seconds), ShipRelay retries up to 3 times with exponential backoff. After 3 failures, the webhook is marked as failed — you'll see a warning in your dashboard.

Example: Slack incoming webhook

Set your webhook URL to a Slack Incoming Webhook URL. The payload can be processed by a Zapier/Make intermediary, or you can build a small serverless function to format it into a Slack message.

Example: Discord webhook

Similar to Slack — use a Discord Webhook URL with a formatting intermediary.