Letterdrop
  • Letterdrop API Docs
  • Finding and using your API key
  • API
    • Social Selling
    • Transcripts
  • Webhooks
    • Leads
Powered by GitBook
On this page

Was this helpful?

  1. API

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 with array format

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

{
  "url": "https://fathom.com",
  "title": "Letterdrop X ABC.com",
  "call_id": "4234324234-1821-345436456-999c-b1dab3f58f92",
  "fomat": "array",
  "trancscript": [
    {
      "words": [
        {
          "text": "It's ",
          "endTimestamp": 3.555000066757202,
          "startTimestamp": 3.265000104904175
        },
        {
          "text": "nice ",
          "endTimestamp": 3.674999952316284,
          "startTimestamp": 3.555000066757202
        },
        {
          "text": "that ",
          "endTimestamp": 3.875,
          "startTimestamp": 3.674999952316284
        },
        {
          "text": "the ",
          "endTimestamp": 3.994999885559082,
          "startTimestamp": 3.875
        },
        {
          "text": "weather's ",
          "endTimestamp": 4.394999980926514,
          "startTimestamp": 3.994999885559082
        },
        {
          "text": "that ",
          "endTimestamp": 4.514999866485596,
          "startTimestamp": 4.394999980926514
        },
        {
          "text": "good, ",
          "endTimestamp": 4.675000190734863,
          "startTimestamp": 4.514999866485596
        },
        {
          "text": "right? ",
          "endTimestamp": 4.954999923706055,
          "startTimestamp": 4.675000190734863
        }
      ],
      "speaker": {
        "name": "Chris Eco",
        "type": "internal",
        "email": "ceco@squiz.net"
      }
    },
    {
      "words": [
        {
          "text": "Yeah. ",
          "endTimestamp": 5.954999923706055,
          "startTimestamp": 5.664999961853027
        },
        {
          "text": "Well ",
          "endTimestamp": 6.275000095367432,
          "startTimestamp": 5.985000133514404
        },
        {
          "text": "it's, ",
          "endTimestamp": 6.635000228881836,
          "startTimestamp": 6.34499979019165
        },
        {
          "text": "it's ",
          "endTimestamp": 7.034999847412109,
          "startTimestamp": 6.744999885559082
        },
        {
          "text": "gonna ",
          "endTimestamp": 7.275000095367432,
          "startTimestamp": 7.034999847412109
        },
        {
          "text": "be ",
          "endTimestamp": 7.474999904632568,
          "startTimestamp": 7.275000095367432
        },
        {
          "text": "good. ",
          "endTimestamp": 7.59499979019165,
          "startTimestamp": 7.474999904632568
        },
        {
          "text": "I'm ",
          "endTimestamp": 7.914999961853027,
          "startTimestamp": 7.695000171661377
        },
        {
          "text": "in ",
          "endTimestamp": 7.994999885559082,
          "startTimestamp": 7.914999961853027
        },
        {
          "text": "Phoenix, ",
          "endTimestamp": 8.274999618530273,
          "startTimestamp": 7.994999885559082
        },
        {
          "text": "but ",
          "endTimestamp": 8.71500015258789,
          "startTimestamp": 8.494999885559082
        },
        {
          "text": "it's ",
          "endTimestamp": 8.994999885559082,
          "startTimestamp": 8.71500015258789
        },
        {
          "text": "kind ",
          "endTimestamp": 9.154999732971191,
          "startTimestamp": 8.994999885559082
        },
        {
          "text": "of ",
          "endTimestamp": 9.234999656677246,
          "startTimestamp": 9.154999732971191
        },
        {
          "text": "chilly ",
          "endTimestamp": 9.595000267028809,
          "startTimestamp": 9.234999656677246
        },
        {
          "text": "right ",
          "endTimestamp": 9.755000114440918,
          "startTimestamp": 9.595000267028809
        },
        {
          "text": "now. ",
          "endTimestamp": 9.954999923706055,
          "startTimestamp": 9.755000114440918
        }
      ],
      "speaker": {
        "name": "Mike Haley",
        "type": "external",
        "email": "mikeh@americaneagle.com"
      }
    },
  "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": [
    "admin@letterdrop.com",
    "customer@abc.com"
  ],
  "call_start_time": "2025-03-06T07:00:25.161Z"
}

Sample payload with plaintext format

{
  "url": "https://fathom.com",
  "title": "Letterdrop X ABC.com",
  "call_id": "4234324234-1821-345436456-999c-b1dab3f58f92",
  "format": "plaintext",
  "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": [
    "admin@letterdrop.com",
    "customer@abc.com"
  ],
  "call_start_time": "2025-03-06T07:00:25.161Z"
}

PreviousSocial SellingNextLeads

Last updated 20 days ago

Was this helpful?