Kiwify API

Name: Kiwify API
Brand: Kiwify API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentE CommerceStorefrontbearer20 EndpointsREST

For Agents

Pull Kiwify sales and product data, issue refunds, manage affiliates, and reconcile creator payouts through the public API.

Install Jentic One Beta

Connect the Kiwify API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Kiwify API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Kiwify API.

List products from a Kiwify creator catalogue with details and pricing

Pull sales records and look up an individual order by id

Issue a refund against a Kiwify sale on behalf of the seller

Aggregate sales statistics for a Kiwify creator account

GET STARTED

Start building with Kiwify API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Kiwify API, keeping it validated and agent-ready. Kiwify is a Brazilian digital product and online course platform that handles checkout, affiliates, payouts, and webhook delivery for creators. The public API exposes products, sales, refunds, affiliates, webhooks, event participants, and finance balances and withdrawals, so creators can pull sales data, automate refund flows, and reconcile payouts outside the dashboard. It also covers OAuth token issuance for partner integrations.

Use Cases

Patterns agents use Kiwify API for, with concrete tasks.

★ Refund Automation for Creators

Automate Kiwify refund handling so support staff or an agent can process refunds without opening the dashboard. The /sales/{order_id} and /sales/{order_id}/refund endpoints expose the order context and refund action together, so an agent can verify a sale before issuing a refund. Useful for course creators with high refund volume during launches.

Look up Kiwify order 'ORD-2024-001', confirm status is 'paid', and call POST /sales/{order_id}/refund to issue a full refund.

Sales Dashboard Sync

Sync Kiwify sales into an internal BI tool or a creator dashboard. The /sales endpoint paginates orders with product, customer, and revenue fields, and /sales/stats gives aggregated KPIs for the same window. Saves creators from CSV exports and keeps revenue numbers fresh in tools like Notion, Airtable, or a custom finance sheet.

Pull Kiwify sales for the last 7 days from /sales, then call /sales/stats and write a daily revenue summary to the creator's reporting sheet.

Affiliate Program Management

Operate a Kiwify affiliate program with programmatic access to affiliate records. The /affiliates endpoints list active partners and let an agent retrieve commission and conversion data per affiliate id. Best for course creators running competitions, sending personalised reports, or paying out top performers automatically.

List Kiwify affiliates, fetch /affiliates/{affiliate_id} for the top 10 by sales, and email each a performance summary.

Webhook-Driven Fulfilment Workflow

Register Kiwify webhooks so downstream tools react to sale and refund events in real time. Use POST /webhooks to attach a destination URL and GET /webhooks to audit current registrations. Combined with the events endpoint this forms a reliable fulfilment trigger for delivering bonus content, granting community access, or revoking access on refund.

Agent-Driven Creator Operations via Jentic

Let an AI agent answer creator questions like 'what did I earn yesterday' or 'refund order ABC' by calling Kiwify through Jentic. The agent searches Jentic for the matching Kiwify operation, loads the schema, and executes with a scoped bearer token. This is much faster than wiring an OAuth client and webhook handler into the agent stack directly.

Through Jentic, search for 'list Kiwify sales', load the /sales operation, and report yesterday's order count and total revenue.

Key Endpoints

20 endpoints — jentic publishes the only available openapi specification for kiwify api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/oauth/token

Issue a Kiwify OAuth bearer token

GET

/products

List creator products

GET

/sales

List sales orders

GET

/sales/{order_id}

Retrieve a single sale

POST

/sales/{order_id}/refund

Issue a refund for a sale

GET

/sales/stats

Aggregate sales statistics

GET

/finance/saldos

Read account balances

POST

/oauth/token

Issue a Kiwify OAuth bearer token

GET

/products

List creator products

GET

/sales

List sales orders

GET

/sales/{order_id}

Retrieve a single sale

POST

/sales/{order_id}/refund

Issue a refund for a sale

GET

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Kiwify OAuth bearer tokens are stored encrypted in the Jentic vault. Agents receive scoped access to /sales, /products, and /webhooks without ever seeing the client_secret used at /oauth/token.

Intent-based discovery

Agents search by intent (e.g., 'refund a Kiwify order', 'list Kiwify sales') and Jentic returns the matching operation with its request schema, so the agent calls the right endpoint without reading the docs.

Time to first call

Direct Kiwify integration: 1-2 days for OAuth setup, webhook registration, and refund flow handling. Through Jentic: under 1 hour — search, load, execute.

FAQs

Specific to using Kiwify API through Jentic.

Why is there no official OpenAPI spec for Kiwify API?

Kiwify does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Kiwify API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Kiwify API use?

The Kiwify API uses OAuth 2.0 with a bearer access token. POST /oauth/token exchanges client credentials for an access token that is then sent as Authorization: Bearer <token> on all other endpoints. Through Jentic, the bearer token is stored in the Jentic vault and the agent never sees the raw secret.

Can I issue refunds through the Kiwify API?

Yes. POST /sales/{order_id}/refund issues a refund against a specific order. Verify the order status with GET /sales/{order_id} first to avoid refunding pending or already-refunded orders.

What are the rate limits for the Kiwify API?

Kiwify does not publish hard rate limits in the public API spec but throttles abusive clients per account. Cache /products and /sales/stats responses where possible — Jentic's runtime caches identical reads across agent runs to reduce hits.

How do I list Kiwify sales from an AI agent through Jentic?

Search Jentic for 'list Kiwify sales', load the GET /sales operation, then execute with a date range filter. Jentic injects the OAuth bearer token from the vault so the agent does not need to handle the /oauth/token exchange directly.

Does the Kiwify API expose creator finance data?

Yes. GET /finance/saldos returns the current account balance and GET /finance/saques lists withdrawals. Use these to reconcile payouts against the sales captured by /sales.

Kiwify API

Connect the Kiwify API to your agent

Capabilities

Start building with Kiwify API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs