Skip to main content
POST
Draft follow-ups

Authorizations

Authorization
string
header
required

Access token issued by gs.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID
string
header
required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Body

application/json

Request body of draft_followups.

conversation_sid
string
required

The thread the follow-ups continue (ub_cv_…): its last message of ours is what they follow; when the lead wrote last, they count from now.

Required string length: 18
Pattern: ^ub_cv_
every_days
integer

Days between the follow-ups, 1..30; default the agent settings' person_followups_every_days (3).

Required range: 1 <= x <= 30
voice
enum<string>

sender: written as the sender profile (the person) would write them, continuing their own message; agent: in the AI SDR's own voice. Default: the last message's author.

Available options:
sender,
agent
count
integer

How many follow-ups to write, 1..3; default the agent settings' person_followups_count (2).

Required range: 1 <= x <= 3
guidance
string | null

What should change, in the person's words, when they read a first draft and ask again (shorter, another angle, a name to mention). Max 1000 chars; omit on the first ask.

Maximum string length: 1000

Response

action success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
action
action
string
required

kebab-case verb; matches the route segment.

item
any
required
result
object
required
meta
object
required