PUT
Update Followup

Overview

This endpoint allows you to update information for an existing followup. You can modify status, add results, update notes, and record completion details. Note that the debt_id cannot be changed.

Authentication

Requires a valid OAuth 2.0 access token with the followups:write scope.

Request

string
required
Bearer token for authentication
string
required
Must be application/json
string
required
The encrypted ID of the followup to update

Request Body

All fields are optional. Only include the fields you want to update.
string
Update the followup status. Use simple string values: on_hold, scheduled, in_progress, sent, delivered, deal_found, no_answer, deal_not_found, bad_behavior, failed, cancelled
string
Type of followup: call, email, sms, whatsapp, voicemail, manual_call, physical, postmail
string
When the followup was executed (ISO 8601 format)
string
When to execute the followup (ISO 8601 format)
string
Brief summary of the followup results
string
Detailed notes about what happened during the followup
string
External call ID from the provider
string
URL to call recording
integer
Duration in milliseconds (for calls)
string
Phone number used for the followup
string
Call direction: inbound or outbound
string
Reason for call disconnection
boolean
Whether this is a retry attempt

Example Request

Response

Returns the updated followup object with the same structure as the Get Followup endpoint.

Success Response

Common Update Scenarios

Mark as Deal Found

Mark as Delivered (for messages)

Record Failed Attempt

Add Call Results

Cancel Followup

Validation Rules

  • status: Must be one of: on_hold, scheduled, in_progress, sent, delivered, deal_found, no_answer, deal_not_found, bad_behavior, failed, cancelled
  • type: Must be one of: call, sms, email, whatsapp, voicemail, manual_call, physical, postmail
  • call_date: Must be in ISO 8601 format
  • scheduled_at: Must be in ISO 8601 format

Error Responses