Transcripts

Add transcript

POST https://api.letterdrop.com/api/v1/transcript/add

Add a transcript for analysis and content idea extraction.

Headers

Name	Type	Description
api-key	string	API key that is unique to your workspace

Request Body

Name	Type	Description
title	string	Title of the sales call
transcript	string[]	The transcript content, where each element represents a segment of text. The entire transcript can also be a single string in the array.
call_start_time	Date	Call Start Time in this format "2025-02-05T14:30:00Z"
call_id	string	Unique identifier for the transcript
url	string	URL of the sales call transcript/recording
participants	string[]	A list of email addresses representing the participants in the transcript. Each element must be a valid email address.
format	string	"array" or "plaintext", by default the format will be accepted as "array". If you send your transcript as a single plain text string, input "plaintext" in format parameter

Sample payload for format - "plaintext"

Follow the format of "transcript" mentioned for "plaintext"

{
  "url": "https://fathom.com",
  "title": "Letterdrop X ABC.com",
  "call_id": "4234324234-1821-345436456-999c-b1dab3f58f92",
  "transcript": "Sales prep call - March 03\nVIEW RECORDING - 14 mins (No highlights): https://fathom.video/share/JxiP-XXXXXXXX\n\n---\n\n0:19 - Admin (Letterdrop)\n  I was in Spain last week, actually, so I, I got back, I I got back. So, I did five days in Barcelona, and then I did two days in Citrus, which is kind of, I don't know if you're familiar, like an hour train ride up the coast of Spain, it was just a bread on the water, but it was beautiful.\n\n0:44 - Customer (abc.com)\n  My youngest brother studying abroad there, so I just went to him for a little bit. Oh, cool. Studying abroad in Spain, it's tough.\n\n0:54 - Admin (Letterdrop)\n  Yeah, he's really, he's really living the life. He like goes somewhere different every weekend, he was just an Athens.  He's going to, like, Dublin for St.\n\n1:02 - Customer (abc.com)\n  Patrick's Day. Oh, luck. Yeah.",
  "participants": [
    "[e-mail]",
    "[e-mail]"
  ],
  "call_start_time": "2025-03-06T07:00:25.161Z",
  "format": "plaintext"
}

Sample payload for format - "array"

{
  "url": "https://fathom.com",
  "title": "Letterdrop X ABC.com",
  "call_id": "4234324234-1821-345436456-999c-b1dab3f58f92",
  "transcript": [
    {
      "words": [
        {
          "text": "I ",
          "endTimestamp": 15.05,
          "startTimestamp": 14.50 // unit in seconds
        },
        {
          "text": " am a software engineer",
          "endTimestamp": 17.0,
          "startTimestamp": 15.50
        }
      ],
      "speaker": {
        "name": "John Doe",
        "type": "internal",
        "email": "[e-mail]"
      }
    },
    {
      "words": [
        {
          "text": "Hi, I'm having trouble with my account login.",
          "startTimestamp": 44.0,
          "endTimestamp": 44.5
        },
        {
          "text": "Could you please assist me?",
          "startTimestamp": 44.6,
          "endTimestamp": 45.0
        }
      ],
      "speaker": {
        "name": "Customer",
        "type": "external",
        "email": "[e-mail]"
      }
    }
  ],
  "participants": [
    "[e-mail]",
    "[e-mail]"
  ],
  "call_start_time": "2025-03-06T07:00:25.161Z",
  "format": "array"
}