---
title: "Webhooks overview"
description: "Inspect webhook events, delivery history, and retries."
---

# Webhooks overview

Use the Webhooks API to inspect event history and delivery attempts, retrieve individual events, and resend supported events.

<CardGroup cols={2}>
  <Card title="Browse webhook endpoints" icon="code" href="/api-reference/webhooks/get-v1-webhooks-history">
    Review delivery history or browse the operations in this category.
  </Card>
  <Card title="Webhooks integration guide" icon="book" href="/platform/webhooks/webhooks-overview">
    Learn how to receive and process Gravv events reliably.
  </Card>
</CardGroup>

## How it works

Gravv delivers webhook events to your configured endpoint as things happen — account changes, inflows, transfers, card activity, collections, and KYC decisions. These API endpoints give you **observability and control** over that delivery pipeline:

- Audit what was sent with the [event history](/api-reference/webhooks/get-v1-webhooks-history), filterable by event type, status, and date range.
- Debug failures by inspecting an [individual event](/api-reference/webhooks/get-v1-webhooks-event-id) — including request/response headers and payload — and its [per-attempt call history](/api-reference/webhooks/get-v1-webhooks-calls-id).
- Recover by [manually retrying](/api-reference/webhooks/post-v1-webhooks-event-send-id) a failed event.

For the list of event types and payload shapes, see the [webhooks integration guide](/platform/webhooks/webhooks-overview).

## Endpoints

| Endpoint | Description |
|---|---|
| [`GET /v1/webhooks/history`](/api-reference/webhooks/get-v1-webhooks-history) | Paginated webhook event history with event-type, status, and date filters |
| [`GET /v1/webhooks/event/{id}`](/api-reference/webhooks/get-v1-webhooks-event-id) | Event details including headers, payload, and delivery attempts |
| [`GET /v1/webhooks/calls/{id}`](/api-reference/webhooks/get-v1-webhooks-calls-id) | Per-attempt delivery call history for an event |
| [`POST /v1/webhooks/event/send/{id}`](/api-reference/webhooks/post-v1-webhooks-event-send-id) | Trigger an immediate manual redelivery (requires the `webhook:create` permission) |

## Authentication

All requests use `https://api.gravv.xyz/v1/` and authenticate with the `Api-Key` header. See [Authentication](/getting-started/authentication) for details.