Webhooks

Receive HTTP payloads from Graceview to build integrations and automation.

1. Overview

Graceview webhooks send HTTP POST payloads to your endpoint when data is created or updated. You can use them to integrate with data lakes, portals, notification systems, or downstream processors.

We currently support two webhook types:

• Article Webhook - fires when the Horizon Scanner processes a new article.

• Publisher Webhook - fires when content is published from a workspace.

Only workspace owners can create webhooks. If you need workspace owner access, contact [email protected].

2. How Graceview Webhooks Work

• Protocol: Graceview sends an HTTP POST with a JSON body to your endpoint.

• Response time: Your endpoint must return HTTP 200 within 5 seconds.

• Retries: If no 2xx is received, Graceview retries up to 5 times with exponential backoff.

• Idempotency: Use payload_id to deduplicate deliveries on your side.

• Testing: Use the Send Test Payload action on each webhook to validate your endpoint before enabling.

3. Resources

For additional information on webhooks, there are a number of good resources:

• RequestBin: Webhooks – The Definitive Guide

• GitHub Developer Guide: Webhooks