> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
---
id: 51f3172f-05d5-4ebc-97e0-2eedcdb92f23
---
# Third-party transcripts
> Enable HubSpot to use transcripts from a third-party platform as a part of its Conversation Intelligence feature.
If you use a third-party solution for transcribing calls, you can sync those transcriptions to HubSpot using the transcription API. This may be a good alternative to [using HubSpot to transcribe third-party calls](/api-reference/latest/crm/extensions/calling-extensions/recordings-and-transcriptions).
## Requirements
Calls to the transcription API must be authenticated with [OAuth](/api-reference/legacy/authentication/oauth-tokens/v1/guide), and your public app must include the following scopes:
* `crm.extensions_calling_transcripts.read`
* `crm.extensions_calling_transcripts.write`
Transcript data is made available to HubSpot by attaching the transcript to a [call activity](/api-reference/latest/crm/activities/calls/guide), so you may need to use the call engagement API to [create](/api-reference/latest/crm/activities/calls/create-call) and [retrieve](/api-reference/latest/crm/activities/calls/get-calls) calls while working with the transcripts API.
## Create a transcript
To create a transcript, make a `POST` request to `/crm/extensions/calling/2026-03/transcripts`. The request body will need to include the ID of the call engagement in HubSpot to attach the transcript to, along with a `transcriptCreateUtterances` array containing the transcript data.
```json theme={null}
{
"engagementId": 21,
"transcriptCreateUtterances": [
{
"speaker": {
"id": "11",
"name": "Speaker_NAME1"
},
"text": "Hello. How are you?",
"languageCode": "en-US",
"startTimeMillis": 1980,
"endTimeMillis": 2090
},
{
"speaker": {
"id": "12",
"name": "Speaker_NAME2",
"email": "speakerName2@gmail.com"
},
"text": "Good, and you?",
"startTimeMillis": 2090,
"endTimeMillis": 3450
}
]
}
```
### Transcript details
The table below lists the top-level transcript fields. Fields marked with \* are required.
| Field | Type | Description |
| -------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------- |
| `engagementId`\* | String | The ID of the HubSpot [call engagement](/api-reference/latest/crm/activities/calls/guide) to attach the transcript to. |
| `transcriptCreateUtterances`\* | Array | A list of objects containing the transcribed call dialogue. The available fields are listed in the table below. |
### Transcript utterances
The table below outlines all available fields you can provide for the `transcriptCreateUtterances` array. Fields marked with \* are required.
| Field | Type | Description |
| --------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `speaker`\* | Object | Contains the following information about the speaker: - `id`\*: the speaker's ID (max 100 characters).
- `name`\*: the speaker's name (max 100 characters).
- `email`: optionally, the speaker's email, which will be matched to a contact record in the account. Must be a valid email.
|
| `text`\* | String | The transcribed text. |
| `languageCode` | String | The speaker's language. Default is `en-US`. |
| `startTimeMillis`\* | Integer | The starting time of the utterance, in milliseconds from the start of the call. Should be a positive number. |
| `endTimeMillis`\* | Integer | The end time of the utterance, in milliseconds from the start of the call. Should be greater than `startTimeMillis`. |
A successful response will return the `id` of the transcript, as generated by HubSpot.
```json theme={null}
{
"id": "5"
}
```
## Retrieve a transcript
To retrieve a transcript from HubSpot, make a `GET` request to `/crm/extensions/calling/2026-03/transcripts/{transcriptId}`.
The response will include the transcript details along with the ID of the associated call engagement.
```json theme={null}
{
"id": "5",
"engagementId": 21,
"transcriptSource": "INTEGRATOR_GENERATED",
"createdAt": "2024-12-05T16:50:00.000Z",
"updatedAt": "2024-12-05T16:50:00.000Z",
"transcriptUtterances": [
{
"id": "1",
"speaker": {
"id": "11",
"name": "Speaker_NAME1"
},
"text": "Hello. How are you?",
"languageCode": "en-US",
"startTimeMillis": 1980,
"endTimeMillis": 2090
},
{
"id": "2",
"speaker": {
"id": "12",
"name": "Speaker_NAME2",
"email": "speakerName2@gmail.com"
},
"text": "Good, and you?",
"startTimeMillis": 2090,
"endTimeMillis": 3450
}
]
}
```
| Field | Type | Description |
| ---------------------- | ------- | --------------------------------------------------------------------------------------------------------------------- |
| `id` | String | The ID of the transcript. |
| `engagementId` | Integer | The ID of the HubSpot [call engagement](/api-reference/latest/crm/activities/calls/guide) attached to the transcript. |
| `transcriptSource` | String | The source of the transcript (will be set to `INTEGRATOR_GENERATED`). |
| `createdAt` | String | The datetime of when the transcript was created in HubSpot. |
| `updatedAt` | String | The datetime of when the transcript was last updated in HubSpot. |
| `transcriptUtterances` | Array | A list of objects containing the transcribed call dialogue. |
| `speaker` | Object | Contains information about the speaker, including their `id`, `name`, and an email address if previously provided. |
| `text` | String | The transcribed text. |
| `languageCode` | String | The speaker's language. Default is `en-US`. |
| `startTimeMillis` | Integer | The starting time of the utterance, in milliseconds from the start of the call. |
| `endTimeMillis` | Integer | The end time of the utterance, in milliseconds from the start of the call. |
## Delete a transcript
To delete a transcript from HubSpot, make a `DELETE` request to `/crm/extensions/calling/2026-03/transcripts/{transcriptId}`.