OverviewAPI ReferenceResources
AI Generation

Generate follow-up email

Drafts a follow-up email from the call. Each request uses one AI credit. A call that doesn't exist returns 404 without using one. The body is optional.

POST
/api/v1/conversations/{id}/email

Authorization

AuthorizationRequiredBearer <token>

A Convo API key: convo_ followed by 32 hex characters. Create it in the Convo desktop app under Settings → Convo API.

In: header

Request Body

application/jsonOptional
recipientNamestring

Name of the email recipient

tonestring

professional, casual or concise

Default: "professional"Value in: "professional" | "casual" | "concise"

Path Parameters

idRequiredstring

Conversation ID from List conversations

curl -X POST "https://www.itsconvo.com/api/v1/conversations/session_1773842400000/email" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientName": "Sarah",
    "tone": "professional"
  }'

Generated email

{
  "data": {
    "id": "session_1773842400000",
    "subject": "Follow-up: Q1 Planning Review",
    "body": "Hi Sarah,\n\nThanks for joining the Q1 Planning Review today. Here are the key takeaways:\n\n- Revenue increased 15% quarter-over-quarter, with enterprise leading at 22% growth\n- Customer retention held at 94%, though SMB churn needs attention\n\nAction items:\n- Alice: Draft enterprise hiring plan by next week\n- Bob: Prepare SMB retention proposal by end of April\n\nLet me know if I missed anything.\n\nBest,\nAlice",
    "keyPoints": [
      "Revenue increased 15% quarter-over-quarter",
      "Enterprise segment grew fastest at 22%",
      "Retention rate held steady at 94%"
    ],
    "actionItems": [
      "Draft enterprise hiring plan (Alice, next week)",
      "Prepare SMB retention proposal (Bob, end of April)"
    ],
    "generatedAt": "2026-03-18T15:05:00.000Z"
  }
}

Was this page helpful?

Generate feedback

Returns the saved feedback, or generates it when there is none. `forceRefresh: true` generates it again. Generating uses one AI credit. It is counted before the transcript is checked, so a 404, or a 400 for a call with fewer than 10 transcript segments, also uses one. Fires `conversation.feedback.ready`.

Query conversation

Answers a question about one call from its transcript. Each request uses one AI credit. A call that doesn't exist returns 404 without using one. `suggestedQueries` are fixed follow-up questions picked from words in your question.