Queue Call
Queue Call
Queue transcript text, uploaded media, or remote audio/video URLs for processing.
POST
Queue Call
Base URL
https://api.objectionly.comEndpoint
POST /api/call-processing/queue
Authentication
Get your API key here:
https://app.objectionly.com/dashboard/integrations
Your workspace API key.
Required only when your workspace is configured to require a proxy token.
Optional source header. Supported values match the
source body field. If
both are sent, the body source value takes precedence.Request Body
Call title.
Rep or host identity. This is usually an email address, but it can also be a
unique rep identifier configured in Objectionly.
ISO-8601 timestamp.
Plain transcript text. This is the preferred text field for new integrations.
Absolute
http(s) URL for a remote audio or video file. Can be used by
itself or together with transcriptText.Multipart file upload for direct media ingestion.
file and mediaUrl
cannot be sent together.Rep or host display name.
Duration in minutes. Must be a positive integer. Defaults to
30 if omitted.Additional context to store with the call.
Used for de-duplication/idempotency across calls.
Optional source value. Supported values:
manually, firefliesai,
fathom, zoom, gohighlevel, zapier, custom_api.Bypasses early short-call filtering when set to
true. For manual imports,
this defaults to true if omitted.Optional list of call attendees. Send up to
10 attendee objects.Provide at least one ingest input:
transcriptText, mediaUrl, or file.name, phone,
email, and uniqueId.
Attendee fields are optional. Objectionly trims attendee values, stores blank
values as
null, and skips attendee objects where every field is blank.Media-only requests are accepted. When you upload a
file or provide a
mediaUrl without transcript text, Objectionly stores the media and
transcribes it later during processing.Supported media types are
.mp3, .wav, .m4a, and .mp4, mapped to
audio/mpeg, audio/wav, audio/m4a, and video/mp4.Examples
- Transcript text (JSON)
- Remote media URL (JSON)
- Transcript + media URL (JSON)
- File upload (multipart)
Responses
- Queued (200)
- Filtered Out (200)
- Duplicate (200)
Remote Media URL Rules
mediaUrlmust be an absolutehttp(s)URL.- In production,
mediaUrlmust usehttps. - The URL must resolve to a public internet address.
- Redirects are allowed, but only up to the configured limit.
- Maximum media size is 500 MB.
- Unsupported media types return
415 Unsupported Media Type.
Errors
| Status | Description |
|---|---|
| 400 | Missing or invalid fields such as title, repEmail, callDate, callDuration, forceImport, source, malformed mediaUrl, malformed multipart attendees, more than 10 attendees, or sending file and mediaUrl together |
| 401 | Missing or invalid authentication |
| 413 | Uploaded or remote media exceeds the 500 MB limit |
| 415 | Unsupported media type |
| 422 | mediaUrl could not be fetched or failed remote URL safety checks |
| 500 | Failed to store media or queue the call |
