Skip to main content
POST
Submit Call Recording (Audio File URL)

Audio Requirements

Before submitting recordings, ensure they meet these requirements:
  • Supported formats: MP3, WAV
  • Maximum file size: 100MB
  • Audio quality: Minimum 8kHz sample rate recommended

Security Recommendation

For better security, we recommend using a time-limited presigned URL instead of a permanently public file URL whenever possible. Learn more: AWS S3 presigned URL sharing

Authorizations

Authorization
string
header
required

API key obtained from the EmberQA dashboard under the "Integrations" tab

Body

application/json
media_url
string<uri>
required

Publicly accessible URL to the audio file (MP3 or WAV, max 100MB)

Example:

"https://example.com/call-audio.mp3"

agent_name
string

Name of the agent who handled the call

Example:

"John D"

language
string

Language code for the call audio. Defaults to English ("en") if not provided.

Example:

"en"

is_inbound
boolean | null
default:true

Boolean flag indicating whether the call was inbound. Defaults to true when omitted.

Example:

true

transcript_url
string<uri>

Optional publicly accessible URL to a plain text transcript file.

transcript_text
string

Optional inline plain text transcript.

Example:

"Speaker 0: Thank you for calling EmberQA.\nSpeaker 1: Hi, I need help with my order."

metadata
object

Optional key-value metadata to store with the call

supporting_docs
string<uri>[]

Optional array of publicly accessible URLs to supporting documents.

Example:

Response

File Accepted

message
string
Example:

"File Accepted"