Skip to main content
POST
Upload a conversation

Authorizations

Authorization
string
header
required

API key authentication using Bearer Token

Body

multipart/form-data
upload[source]
enum<string>
required

The source system or platform from which the call is being uploaded

Available options:
xcally
upload[metadata][unique_id]
string
required

Unique identifier for the call

upload[metadata][type]
enum<string>
required

The direction of the call (inbound or outbound)

Available options:
inbound,
outbound
upload[metadata][agent]
string
required

The agent email address. Used to identify the employee on the call for both inbound and outbound uploads.

upload[metadata][caller]
string
required

Inbound: customer phone number. Outbound: agent email (may duplicate upload[metadata][agent]).

upload[metadata][called]
string
required

Inbound: trunk or extension phone number. Outbound: customer phone number.

upload[metadata][recorded_at]
string
required

The date and time the call was recorded

upload[file]
file
required

The audio recording file (WAV, MP3, or M4A format, max 100MB)

Response

201 - application/json

Conversation uploaded successfully

data
object
required