Skip to main content
POST
Queue Call

Base URL

https://api.objectionly.com

Endpoint

POST /api/call-processing/queue

Authentication

string
required
Your workspace API key.
string
Required only when your workspace is configured to require a proxy token.
string
Optional source header. Supported values match the source body field. If both are sent, the body source value takes precedence.

Request Body

string
default:"Discovery call - Acme"
required
Call title.
string
default:"rep@acme.com"
required
Rep or host identity. This is usually an email address, but it can also be a unique rep identifier configured in Objectionly.
string
default:"2026-01-31T18:30:00Z"
required
ISO-8601 timestamp.
string
Plain transcript text. This is the preferred text field for new integrations.
string
Absolute http(s) URL for a remote audio or video file. Can be used by itself or together with transcriptText.
string
Multipart file upload for direct media ingestion. file and mediaUrl cannot be sent together.
string
Rep or host display name.
number
Duration in minutes. Must be a positive integer. Defaults to 30 if omitted.
string
Additional context to store with the call.
string
Used for de-duplication/idempotency across calls.
string
Optional source value. Supported values: manually, firefliesai, fathom, zoom, gohighlevel, zapier, custom_api.
boolean
Bypasses early short-call filtering when set to true. For manual imports, this defaults to true if omitted.
array
Optional list of call attendees. Send up to 10 attendee objects.
Provide at least one ingest input: transcriptText, mediaUrl, or file.
Attendees should be sent as an array. Each attendee can include name, phone, email, and uniqueId.
Example with one attendee:
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

Responses

string
required
Unique identifier for the queued call.
string
required
Queue status for the call.
boolean
required
Indicates the call was queued successfully.

Remote Media URL Rules

  • mediaUrl must be an absolute http(s) URL.
  • In production, mediaUrl must use https.
  • 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