KOLens Webhooks API
The Webhooks API from KOLens — 2 operation(s) for webhooks.
The Webhooks API from KOLens — 2 operation(s) for webhooks.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/kolens-ai:kolens-ai-webhooks-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: KOLens Webhooks API
description: KOLens — TikTok KOL Intelligence API. Search keywords, extract KOL profiles, collect contact info, export reports.
version: 1.0.0
tags:
- name: Webhooks
paths:
/webhooks/apify:
post:
tags:
- Webhooks
summary: Apify Webhook
description: 'Persist the raw Apify webhook payload after verifying the
per-task token. Always returns 200 (even on duplicate / bad
token / unparseable body) so Apify doesn''t keep retrying — the
inbox row carries enough state for the processor / admin UI
to act on.'
operationId: apify_webhook_webhooks_apify_post
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Apify Webhook Webhooks Apify Post
/webhooks/stripe:
post:
tags:
- Webhooks
summary: Stripe Lifecycle Webhook
description: 'Fan out a Stripe lifecycle event to Slack + Loops.so.
Called by ``kolens-web/app/api/stripe/webhook/route.ts`` AFTER the
Stripe signature has been verified on Vercel. Auth is the shared
``X-Admin-Secret`` (same pattern as ``/api/workspaces/.../billing/
credit-grant``). Returns 200 with ``{received, processed,
slack_sent, loops_sent}`` so the BFF can log what fired without
needing to wait on either downstream provider.
Event types handled:
* ``checkout.session.completed`` →
Slack: ``:tada: New paying customer: (, )``
Loops: ``subscription_purchased``
* ``customer.subscription.deleted`` →
Slack: ``:disappointed: Churned customer: ``
Loops: ``subscription_canceled``
* ``invoice.payment_failed`` →
Slack: ``:warning: Payment failed: ``
Loops: ``payment_failed``
Any other event type returns 200 with ``processed=False`` —
unknown types are not an error. All integrations gracefully no-op
when their env keys are unset; the response reflects what actually
fired.'
operationId: stripe_lifecycle_webhook_webhooks_stripe_post
parameters:
- name: X-Admin-Secret
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Admin-Secret
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/StripeLifecycleEvent'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Stripe Lifecycle Webhook Webhooks Stripe Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
StripeLifecycleEvent:
properties:
stripe_event_id:
type: string
maxLength: 128
minLength: 4
title: Stripe Event Id
type:
type: string
maxLength: 80
minLength: 4
title: Type
email:
anyOf:
- type: string
maxLength: 320
- type: 'null'
title: Email
plan:
anyOf:
- type: string
maxLength: 80
- type: 'null'
title: Plan
amount_cents:
anyOf:
- type: integer
minimum: 0.0
- type: 'null'
title: Amount Cents
currency:
anyOf:
- type: string
maxLength: 8
- type: 'null'
title: Currency
workspace_slug:
anyOf:
- type: string
maxLength: 80
- type: 'null'
title: Workspace Slug
type: object
required:
- stripe_event_id
- type
title: StripeLifecycleEvent
description: 'Minimal payload the Vercel BFF forwards after signature verification.
Stripe''s native event shape is huge; we accept just the fields the
fanout actually uses. ``stripe_event_id`` is the ``evt_...`` id
Stripe sends — used for idempotency. ``type`` is the Stripe event
type (``checkout.session.completed`` etc.).'
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
HTTPBearer:
type: http
scheme: bearer