How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
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 Webhook, Payments, Donations, Membership, 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 ↑
Where this information came from

This is an independent, third-party profile of Ko-fi Webhook, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.