CRM

Send Outreach By Kol Route

Find-or-create a conversation for username and send the email.

Convenience endpoint for the KOL detail page's Outreach panel where the user composes a draft against a KOL handle, not against an existing conversation. Find-or-create on (workspace, platform, username) so repeated sends pile up on the same conversation timeline instead of fragmenting it.

Credits are charged by the Vercel BFF before it calls us — if SendGrid rejects, we surface 502 and the BFF refunds. Keeping the debit on the BFF side avoids cross-system distributed-transaction pain (Supabase Postgres vs Railway Postgres are not the same DB).

post/api/crm/kols/{username}/send-outreach

Request

  • Base URL: https://api.kolens.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.kolens.ai/api/crm/kols/{username}/send-outreach
  • Auth: HTTP bearer

Path parameters

usernamestring required

Headers

x-kolens-user-idstring nullable
x-kolens-workspace-idstring nullable
x-kolens-user-namestring nullable

Request body

to_addrstring required
subjectstring required
body_textstring required
body_htmlstring nullable
kol_platformstring

Response

Successful Response

event_idstring required
conversation_idstring required
reply_tostring required
is_new_conversationboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.