USusepylon
call-recordings

Create a call recording

Changed on

Creates a call recording from your own call recorder. Set app_type to custom_call_recorder; the Custom Call Recorder integration must be enabled for your organization, or the request returns 400. start_time, end_time, and at least one call_recording_messages entry are required. Every speaker_email must appear in participant_emails or match primary_user_email. The recording is linked to account_id if provided, otherwise to an account matched from the participant emails. Reusing a recording_id returns the existing recording unchanged.

Rate limit: 30 requests per minute

post/call-recordings

Request

  • Base URL
    https://api.usepylon.com
  • URL
    https://api.usepylon.com/call-recordings
  • Auth
    HTTP bearer

Request body

account_idstring

The ID of the account to link this call recording to. If provided, the participant emails are not used for account matching, and an unknown ID returns 400. If omitted, Pylon matches an account from the participant emails, ignoring your organization's own domains; the recording is created without an account if none matches.

app_type'custom_call_recorder' required

The source of the recording. Must be custom_call_recorder, which requires the Custom Call Recorder integration to be enabled.

end_timestring date-time required

When the call ended, in RFC3339 format (e.g. 2025-01-01T01:00:00Z).

participant_emailsstring

Comma-separated emails of everyone on the call (e.g. "alice@customer.com,bob@yourcompany.com"). Used to match the account when account_id is omitted. Every speaker_email in call_recording_messages must be in this list or match primary_user_email.

primary_user_emailstring

The email of the Pylon user who owns the recording. Counted as a participant, so it does not need to be repeated in participant_emails.

recording_idstring

Your unique ID for this recording. Pylon deduplicates on recording_id and app_type: a request that reuses a recording_id returns the existing recording unchanged. Send a unique value for every call; if you omit it, every request after the first returns the same recording.

recording_urlstring

A link to the recording in your call recorder. Maximum 255 characters.

start_timestring date-time required

When the call started, in RFC3339 format (e.g. 2025-01-01T00:00:00Z).

titlestring

The title of the call recording.

Example request

{
  "app_type": "custom_call_recorder"
}

Response

request_idstring required

The request ID for tracking.

Example response

{
  "data": {
    "custom_fields": {
      "sentiment": {
        "value": "positive"
      }
    }
  }
}

Changes