# flatmark Webhooks API

**Canonical:** https://apis.io/apis/flatmark-dev/flatmark-dev-webhooks-api/  
**Provider:** flatmark — https://apis.io/providers/flatmark-dev/  
**Base URL:** https://api.flatmark.dev  
**Documentation:** https://flatmark.dev/docs

flatmark Webhooks API is one of 4 APIs that [flatmark](https://apis.io/providers/flatmark-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include Webhook. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas.

Get events POSTed to your own https endpoint, signed per [Standard Webhooks](https://www.standardwebhooks.com/): verify the `webhook-signature` header with the endpoint's secret, and use `webhook-id` to drop duplicates. A failed delivery is retried for a little over a day.

## Operations (4)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/webhooks` | List your webhook endpoints |
| POST | `/v1/webhooks` | Create a webhook endpoint |
| DELETE | `/v1/webhooks/{endpoint_id}` | Delete a webhook endpoint |
| POST | `/v1/webhooks/{endpoint_id}/test` | Send a test event to a webhook endpoint |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/flatmark-dev/openapi/flatmark-dev-webhooks-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/flatmark-dev/json-schema/flatmark-dev-webhook-endpoint-created-schema.json
- **JSONSchema** — https://artifacts.apis.io/flatmark-dev/json-schema/flatmark-dev-webhook-endpoint-request-schema.json

## Other flatmark APIs (3)

- [flatmark Account API](https://apis.io/apis/flatmark-dev/flatmark-dev-account-api/)
- [flatmark Convert API](https://apis.io/apis/flatmark-dev/flatmark-dev-convert-api/)
- [flatmark Jobs API](https://apis.io/apis/flatmark-dev/flatmark-dev-jobs-api/)

## Tags

Webhook

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/flatmark-dev/flatmark-dev-webhooks-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/flatmark-dev/.