API documentation

POST /scheduled_callbacks

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/scheduled_callbacks

Create a Scheduled Callback

Schedules a callback to a lead for place_call_at (interpreted in place_call_time_zone), identified by call_id, lead_id, or a phone number plus schedule_id. If the lead already has a scheduled callback it is updated rather than duplicated; if the lead has no schedule yet it is assigned to schedule_id. Requires agent or superuser access, or the request is rejected.

Params

Param name	Description
to Optional Blank value allowed	The telephone number for the consumer who will receive a callback. Must be a String
schedule_id Optional Blank value allowed	The schedule that the callback will be associated with. Must be a valid foreign key reference to an Schedule. Refer to: /api/docs/1.0/schedules
call_id Optional Blank value allowed	The callback will be made against this call. Must be a valid foreign key reference to an Call. Refer to: /api/docs/1.0/calls
lead_id Optional Blank value allowed	The callback will be made against this lead. Must be a valid foreign key reference to an Lead. Refer to: /api/docs/1.0/leads
connect_with Required	Who Should The Consumer Talk To? Must be one of: `me`, `anyone`, `connect_with_buyer_id`.
place_call_at Required	When should the callback occur? Must be a valid time: 2026-10-04 18:06:05 +0000
place_call_time_zone Required	The time zone that will be used when parsing place_call_at Must be a valid time zone. See the list of valid time zones.

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.com/api/v1/scheduled_callbacks/' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "to": "+18005550187",
  "schedule_id": 10001,
  "connect_with": "anyone",
  "place_call_at": "2027-06-15 10:00:00",
  "place_call_time_zone": "Eastern Time (US & Canada)"
}'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "scheduled_callback": {
    "id": 10002,
    "type": "ScheduledCallback",
    "uuid": null,
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/scheduled_callbacks/10002",
    "routes_edit_path": "/scheduled_callbacks/10002/edit",
    "external_record_id": null,
    "company_id": 10003,
    "lead_id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "collaborator_id": null,
    "connect_with": "anyone",
    "place_call_at": "2026-01-15T15:30:00.000Z",
    "place_call_time_zone": "Eastern Time (US & Canada)",
    "name": "+18005550187",
    "schedule_id": 10004,
    "offer_id": 10005,
    "connect_with_buyer_id": null,
    "recent_call_ids": [],
    "caller_number": "+18005550187"
  },
  "metadata": {
    "root": "scheduled_callback"
  }
}