KOLens Admin / Email test API
The Admin / Email test API from KOLens — 4 operation(s) for admin / email test.
The Admin / Email test API from KOLens — 4 operation(s) for admin / email test.
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-admin-email-test-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 Admin / Email test API
description: KOLens — TikTok KOL Intelligence API. Search keywords, extract KOL profiles, collect contact info, export reports.
version: 1.0.0
tags:
- name: Admin / Email test
paths:
/admin/email-test/send-outreach:
post:
tags:
- Admin / Email test
summary: Send Test Outreach
description: 'Send a test outreach email through the real SendGrid pipeline.
The recipient (your own inbox usually) gets a normal-looking email
whose ``Reply-To`` is ``reply+@``.
Reply from your inbox normally; SendGrid Inbound Parse routes the
reply back to ``POST /api/crm/inbound`` and it lands on this
conversation''s timeline. Use ``GET /admin/email-test//events``
to verify the round-trip.'
operationId: send_test_outreach_admin_email_test_send_outreach_post
parameters:
- name: x-kolens-user-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Kolens-User-Id
- name: x-kolens-user-name
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Kolens-User-Name
- 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/SendOutreachRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SendOutreachResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/admin/email-test/simulate-inbound:
post:
tags:
- Admin / Email test
summary: Simulate Inbound Reply
description: 'Inject a synthetic inbound reply WITHOUT going through SendGrid.
Useful when DNS / SendGrid dashboard isn''t set up yet, or for fast
iteration. Synthesises a SendGrid-shaped payload and calls
``ingest_inbound_email`` directly with a fresh
``sendgrid_message_id`` so we don''t trip the dedupe gate.'
operationId: simulate_inbound_reply_admin_email_test_simulate_inbound_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/SimulateInboundRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SimulateInboundResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/admin/email-test/conversations:
get:
tags:
- Admin / Email test
summary: List Test Conversations
description: 'List recent ``kol_platform=''test''`` conversations belonging to
the admin''s workspace. Most recent activity first.'
operationId: list_test_conversations_admin_email_test_conversations_get
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 200
minimum: 1
default: 50
title: Limit
- name: x-kolens-user-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Kolens-User-Id
- name: x-admin-secret
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Admin-Secret
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/TestConversationOut'
title: Response List Test Conversations Admin Email Test Conversations Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/admin/email-test/{conversation_id}/events:
get:
tags:
- Admin / Email test
summary: List Test Events
description: 'List events on a test conversation. Used by the admin page to
poll for incoming replies after the operator hits send.'
operationId: list_test_events_admin_email_test__conversation_id__events_get
parameters:
- name: conversation_id
in: path
required: true
schema:
type: string
title: Conversation Id
- name: limit
in: query
required: false
schema:
type: integer
maximum: 500
minimum: 1
default: 100
title: Limit
- name: x-kolens-user-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Kolens-User-Id
- name: x-admin-secret
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Admin-Secret
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/TestEventOut'
title: Response List Test Events Admin Email Test Conversation Id Events Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
TestEventOut:
properties:
id:
type: string
title: Id
kind:
type: string
title: Kind
direction:
anyOf:
- type: string
- type: 'null'
title: Direction
subject:
anyOf:
- type: string
- type: 'null'
title: Subject
body_text:
anyOf:
- type: string
- type: 'null'
title: Body Text
body_html:
anyOf:
- type: string
- type: 'null'
title: Body Html
sender_email:
anyOf:
- type: string
- type: 'null'
title: Sender Email
sendgrid_message_id:
anyOf:
- type: string
- type: 'null'
title: Sendgrid Message Id
created_at:
type: string
format: date-time
title: Created At
type: object
required:
- id
- kind
- direction
- subject
- body_text
- body_html
- sender_email
- sendgrid_message_id
- created_at
title: TestEventOut
SendOutreachResponse:
properties:
conversation_id:
type: string
title: Conversation Id
event_id:
type: string
title: Event Id
to_email:
type: string
title: To Email
reply_to_address:
type: string
title: Reply To Address
workspace_id:
type: string
title: Workspace Id
note:
type: string
title: Note
type: object
required:
- conversation_id
- event_id
- to_email
- reply_to_address
- workspace_id
- note
title: SendOutreachResponse
TestConversationOut:
properties:
id:
type: string
title: Id
kol_username:
type: string
title: Kol Username
status:
type: string
title: Status
last_event_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Last Event At
created_at:
type: string
format: date-time
title: Created At
event_count:
type: integer
title: Event Count
type: object
required:
- id
- kol_username
- status
- last_event_at
- created_at
- event_count
title: TestConversationOut
SimulateInboundRequest:
properties:
conversation_id:
type: string
title: Conversation Id
from_email:
type: string
maxLength: 254
minLength: 5
title: From Email
subject:
type: string
maxLength: 200
minLength: 1
title: Subject
body_text:
type: string
maxLength: 20000
minLength: 1
title: Body Text
body_html:
anyOf:
- type: string
maxLength: 50000
- type: 'null'
title: Body Html
type: object
required:
- conversation_id
- from_email
- subject
- body_text
title: SimulateInboundRequest
SendOutreachRequest:
properties:
to_email:
type: string
maxLength: 254
minLength: 5
title: To Email
subject:
type: string
maxLength: 200
minLength: 1
title: Subject
body_text:
type: string
maxLength: 20000
minLength: 1
title: Body Text
body_html:
anyOf:
- type: string
maxLength: 50000
- type: 'null'
title: Body Html
type: object
required:
- to_email
- subject
- body_text
title: SendOutreachRequest
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
SimulateInboundResponse:
properties:
event_id:
type: string
title: Event Id
conversation_id:
type: string
title: Conversation Id
status_after:
type: string
title: Status After
note:
type: string
title: Note
type: object
required:
- event_id
- conversation_id
- status_after
- note
title: SimulateInboundResponse
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
HTTPBearer:
type: http
scheme: bearer