---
updatedAt: 2026-04-28T13:19:55.000Z
agentTools:
  projectIndex: https://dev.frontapp.com/llms.txt
---

# Add call recording

Adds a recording to a call in Front. Send `multipart/form-data` with exactly one file in the `attachments` field, `Content-Type: audio/*`, and required `recording_type` (`call` or `voicemail`).


# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "x-api-id": "front",
  "x-explorer-enabled": false,
  "x-proxy-enabled": true,
  "x-samples-enabled": true,
  "info": {
    "version": "1.0.0",
    "title": "Channel API",
    "contact": {
      "name": "Front Platform",
      "url": "https://community.front.com"
    }
  },
  "security": [
    {
      "http": []
    }
  ],
  "servers": [
    {
      "url": "https://api2.frontapp.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "http": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "paths": {
    "/channels/{channel_id}/calls/{external_call_id}/recording": {
      "post": {
        "summary": "Add call recording",
        "operationId": "add-call-recording",
        "description": "Adds a recording to a call in Front. Send `multipart/form-data` with exactly one file in the `attachments` field, `Content-Type: audio/*`, and required `recording_type` (`call` or `voicemail`).\n",
        "tags": [
          "Calls"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "channel_id",
            "required": true,
            "description": "The Channel ID.",
            "schema": {
              "type": "string",
              "default": "cha_123"
            }
          },
          {
            "in": "path",
            "name": "external_call_id",
            "required": true,
            "description": "The external call ID from the provider system.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "attachments",
                  "recording_type"
                ],
                "properties": {
                  "attachments": {
                    "type": "string",
                    "format": "binary",
                    "description": "Exactly one audio file (`audio/*`)."
                  },
                  "recording_type": {
                    "type": "string",
                    "enum": [
                      "call",
                      "voicemail"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted"
          },
          "400": {
            "description": "Bad Request"
          }
        },
        "x-required-scopes": [
          "channels:write"
        ]
      }
    }
  }
}
```