Calls

Upload a call

Upload a call to Modjo via a recording URL. Modjo will download the recording asynchronously. The call becomes visible within a few seconds. Typical total processing time: 5-30 minutes. The callId in the response is a UUID, usable with GET /v1/calls/:id.

post/calls

Request body

downloadMediaUrlstring uri required

Publicly accessible recording URL. Modjo will download the file from this URL.

namestring

Call title. If omitted, auto-generated from participant names.

datestring date-time required

Call start datetime in ISO 8601 format

direction'inbound' | 'outbound'

Call direction. Defaults to outbound.

durationnumber

Call duration in seconds. Can be 0 or omitted.

tagsstring[]

Tag names to attach to the call

Example request

{
  "downloadMediaUrl": "https://storage.example.com/recordings/call-123.mp3",
  "name": "Demo call with Acme Corp",
  "date": "2024-06-15T14:30:00.000Z",
  "direction": "outbound",
  "duration": 1800,
  "participants": [
    {
      "email": "jane.doe@company.com",
      "name": "Jane Doe",
      "type": "user"
    }
  ],
  "tags": [
    "demo",
    "enterprise"
  ],
  "account": {
    "crm": "salesforce",
    "crmId": "001ABC123"
  },
  "deal": {
    "crm": "salesforce",
    "crmId": "006DEF456"
  }
}

Response

Call accepted for processing

callIdstring uuid required

UUID of the created call. Use with GET /calls/{id} to poll for processing status.

status'processing' required

Call is queued for async processing

Example response

{
  "callId": "550e8400-e29b-41d4-a716-446655440000"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.