Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Ko-fi Webhook

Outbound webhook that Ko-fi HTTP POSTs to a URL you configure whenever a payment happens on your Ko-fi page. The single POST body is form-encoded with a "data" field containing a JSON payload; a "type" field distinguishes the event - Donation, Subscription, Shop Order, or Commission - and a verification_token confirms the request came from Ko-fi. This is a one-way, server-to-endpoint notification, not a readable/queryable REST API. Modeled in asyncapi/ko-fi-asyncapi.yml as an inbound HTTP webhook (not WebSocket).

Ko-fi Webhook is published by Ko-fi on the APIs.io network, described by an AsyncAPI event-driven specification.

Tagged areas include Webhooks, Payments, Donations, Memberships, and Shop Orders. The published artifact set on APIs.io includes API documentation and an AsyncAPI specification.

This event API exposes 1 operation across 1 channel, and defines 5 schemas. It is described by AsyncAPI 2.6.0, at version 1.0.0.

The API connects through a single server, {yourWebhookUrl} (https).

1 operations 1 channels 5 schemas

Metadata

The identity and technical contract details declared by the specification.

Specification
AsyncAPI 2.6.0
API Version
1.0.0
Server
{yourWebhookUrl} (https)
Resource Areas
1

Channels & Operations 1

Across 1 channel, the API surfaces 1 operation. Each is listed below with its action, channel, parameters, and response codes.

Channels 1
SUB
ko-fi/payment
Receive a Ko-fi payment notification.
receiveKoFiPayment body

Messages & Schemas 5

The contract defines 5 schemas that model the data carried by its messages. The most detailed is KoFiPayment (17 properties). Each schema is shown below with its type and property counts.

Donation
message
A one-off tip or donation to your Ko-fi page.
Subscription
message
A recurring membership payment. Fires on each payment, including the first.
ShopOrder
message
A purchase from your Ko-fi Shop. Includes shopitems and, for physical goods, shipping.
Commission
message
A paid commission request. Ko-fi documents Commission as a webhook type but does not publish an example payload; it follows the same base shape as other paymen…
KoFiPayment
object
The JSON object carried in the form-encoded "data" field of every Ko-fi payment webhook POST. Field presence varies by event type (for example, shopitems and s…
17 properties 7 required

Specification

The full machine-readable AsyncAPI contract behind this narrative.

Source

ko-fi-asyncapi.yml Raw ↑