---
title: "Call Recording Available"
method: POST
path: "/CALL_RECORDING_AVAILABLE"
tags: ["Agent Activity"]
---

# Call Recording Available

`POST /CALL_RECORDING_AVAILABLE`

## Request

- Base URL: `https://apidocs.goaugment.com` (the document declares no server; this is the origin it was published from)
- URL: `https://apidocs.goaugment.com/CALL_RECORDING_AVAILABLE`
- Auth: none declared
- TypeScript: <https://skmtc.dev/goaugment/apis/webhooks/docs/CALL_RECORDING_AVAILABLE/post.ts> (a function with typed inputs; its response is checked against the schema)

> v1 equivalent: `CALL_RECORDING_AVAILABLE` (flat payload).

Sent when a signed, time-limited link to download a completed call's recording becomes available. This event only fires for calls that have a recording, and `data.recording` is populated on every delivery.

`recording.downloadUrl` is valid for up to 1 hour from when this event is sent. Check `recording.expiresAt` and fetch the recording well before that time — once it expires the link stops working and cannot be reissued for this event.

`customerLoadInternalId` on this event depends on your TMS integration supplying an internal identifier for the load; it is not guaranteed to be populated for every load.

## Request body

- CallRecordingAvailableEvent: Fields present on every v2 webhook event.
  - `id` string, required: Unique event identifier (ULID)
  - `workflow` 'TRACK_AND_TRACE' | 'CARRIER_SUPPORT' | 'POD_COLLECTION' | 'LOAD_BUILDING' | 'CARRIER_SELECTION' | 'SCHEDULING' | 'CUSTOMER_SUPPORT' | 'null', nullable, required: The Augment workflow that produced this event, or `null` when no single workflow can be attributed. New values may be added over time, so treat this as an open set rather than a fixed list.
  - `occurredAt` string, date-time, required: When the underlying activity occurred (ISO 8601)
  - `loadNumber` string, nullable, required: Your load reference number
  - `customerLoadInternalId` string, nullable, required: Your internal load ID, if provided during load creation
  - `eventType` 'CALL_RECORDING_AVAILABLE', required: Event name for a call recording becoming available for download.
  - `data` CallRecordingData, required: A completed call's recording, with a link to download it.
    - `callId` string, required: Augment's identifier for the call.
    - `direction` 'INBOUND' | 'OUTBOUND', required: Direction of the communication from Augment's point of view. `OUTBOUND` means Augment initiated it; `INBOUND` means Augment received it.
    - `callStatus` string: How the call ended. Treat as an open set; `UNKNOWN` covers any value Augment does not yet recognize.
    - `timestamp` string, date-time, required: When the call occurred, in UTC ISO 8601 format.
    - `contact` CallRecordingContact, required: The person on the call.
      - `name` string, required: Contact's name.
      - `phone` string, required: Contact's phone number in E.164 format.
      - `phoneExtension` string: Contact's phone extension.
      - `role` string: The contact's role, when Augment has one. Treat as an open set.
    - `recording` object: Populated on every delivery of this event, since a failure to produce a link fails the whole delivery rather than sending this event without it.
      - `downloadUrl` string, uri, required: Signed link to download the recording, valid for up to 1 hour from when this event is sent. Fetch it before `expiresAt` — once it expires the link stops working and cannot be reissued for this event.
      - `expiresAt` string, date-time, required: When `downloadUrl` stops working, in UTC ISO 8601 format.

## Response `200`

Event acknowledged

---

[API](https://skmtc.dev/goaugment/apis/webhooks.md) - [All operations](https://skmtc.dev/goaugment/apis/webhooks/llms.txt) - [OpenAPI document](https://skmtc.dev/goaugment/apis/webhooks/revisions/a074b2ada419?raw)