KOLens Admin / Email test API

The Admin / Email test API from KOLens — 4 operation(s) for admin / email test.

GitHub OpenAPI

Operations 4

POST /admin/email-test/send-outreach Send Test Outreach #
POST /admin/email-test/simulate-inbound Simulate Inbound Reply #
GET /admin/email-test/conversations List Test Conversations #
GET /admin/email-test/{conversation_id}/events List Test Events #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/kolens-ai:kolens-ai-admin-email-test-api"
All apis
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.

Get an API 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 Specification

kolens-ai-admin-email-test-api-openapi.yml Raw ↑
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