API documentation

GET /scheduled_callbacks

Authorization Required

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

List scheduled callbacks.

Lists scheduled callbacks, future calls the system will place back to a lead, ordered by when they're due to go out by default. Requires agent or superuser access; supports CSV export.

Example Request

curl 'https://[your-subdomain].trackdrive.com/api/v1/scheduled_callbacks/?per_page=2' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "scheduled_callbacks": [
    {
      "id": 10001,
      "type": "ScheduledCallback",
      "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
      "created_at": "2026-01-15T13:30:00.000Z",
      "updated_at": "2026-01-15T13:30:00.000Z",
      "deleted_at": null,
      "user_updated_at": null,
      "routes_show_path": "/scheduled_callbacks/10001",
      "routes_edit_path": "/scheduled_callbacks/10001/edit",
      "external_record_id": null,
      "company_id": 10002,
      "lead_id": "a09e6bca-255b-4217-af73-cb9601c80217",
      "collaborator_id": 10003,
      "connect_with": "anyone",
      "place_call_at": "2026-01-15T14:30:00.000Z",
      "place_call_time_zone": "America/New_York",
      "name": "Linda Hernandez",
      "schedule_id": 10004,
      "offer_id": 10005,
      "connect_with_buyer_id": null,
      "recent_call_ids": [],
      "caller_number": "13055550103"
    },
    {
      "id": 10006,
      "type": "ScheduledCallback",
      "uuid": "49cca320-d2dd-4768-a730-8fc3e0a664e7",
      "created_at": "2026-01-15T13:30:00.000Z",
      "updated_at": "2026-01-15T13:30:00.000Z",
      "deleted_at": null,
      "user_updated_at": null,
      "routes_show_path": "/scheduled_callbacks/10006",
      "routes_edit_path": "/scheduled_callbacks/10006/edit",
      "external_record_id": null,
      "company_id": 10002,
      "lead_id": "8a10bcf5-8767-4aa3-a10b-5458e72d5bf9",
      "collaborator_id": 10007,
      "connect_with": "anyone",
      "place_call_at": "2026-01-15T15:30:00.000Z",
      "place_call_time_zone": "America/Chicago",
      "name": "David Smith",
      "schedule_id": 10008,
      "offer_id": 10009,
      "connect_with_buyer_id": null,
      "recent_call_ids": [],
      "caller_number": "13125550106"
    }
  ],
  "metadata": {
    "root": "scheduled_callbacks",
    "page": 1,
    "total_pages": 2,
    "per_page": 2,
    "total_count": 3,
    "next_cursor": 10010
  }
}

GET /scheduled_callbacks/new

Authorization Required

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

Returns a new Scheduled Callback

Returns a new, unsaved Scheduled Callback for the given call_id or lead_id, with its offer and schedule inherited from that call. Requires agent or superuser access, or the request is rejected; even then, an agent account without permission to access calls gets back an empty response instead of the built record.

Params

Param name	Description
call_id Optional	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	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

Param name

Description

call_id
Optional

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

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

Example Request

curl 'https://[your-subdomain].trackdrive.com/api/v1/scheduled_callbacks/new' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "scheduled_callback": {
    "id": null,
    "type": "ScheduledCallback",
    "uuid": null,
    "created_at": null,
    "updated_at": null,
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/scheduled_callbacks/new",
    "routes_edit_path": "/scheduled_callbacks/new",
    "external_record_id": null,
    "company_id": 10001,
    "lead_id": null,
    "collaborator_id": null,
    "connect_with": "me",
    "place_call_at": "2026-01-15T15:30:00.000Z",
    "place_call_time_zone": "Eastern Time (US & Canada)",
    "name": null,
    "schedule_id": null,
    "offer_id": null,
    "connect_with_buyer_id": null,
    "recent_call_ids": [],
    "caller_number": null
  },
  "metadata": {
    "root": "scheduled_callback"
  }
}

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-06 01:07:17 +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"
  }
}

GET /scheduled_callbacks/:id

Authorization Required

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

Returns a Scheduled Callback by ID

Fetches a Scheduled Callback by id, or by call_id/lead_id if no callback has been created for that id yet. Requires agent or superuser access, or the request is rejected.

Params

Param name	Description
call_id Optional	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	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

Param name

Description

call_id
Optional

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

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

Example Request

curl 'https://[your-subdomain].trackdrive.com/api/v1/scheduled_callbacks/10001' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "scheduled_callback": {
    "id": 10001,
    "type": "ScheduledCallback",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T14:30:00.000Z",
    "updated_at": "2026-01-15T14:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/scheduled_callbacks/10001",
    "routes_edit_path": "/scheduled_callbacks/10001/edit",
    "external_record_id": null,
    "company_id": 10002,
    "lead_id": "a09e6bca-255b-4217-af73-cb9601c80217",
    "collaborator_id": 10003,
    "connect_with": "anyone",
    "place_call_at": "2026-01-15T15:30:00.000Z",
    "place_call_time_zone": "America/New_York",
    "name": "Linda Hernandez",
    "schedule_id": 10004,
    "offer_id": 10005,
    "connect_with_buyer_id": null,
    "recent_call_ids": [],
    "caller_number": "13055550103"
  },
  "metadata": {
    "root": "scheduled_callback"
  }
}

PUT /scheduled_callbacks/:id

Authorization Required

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

Updates a Scheduled Callback by ID

Updates a Scheduled Callback's connect_with target, place_call_at, or place_call_time_zone. Requires agent or superuser access, or the request is rejected.

Params

Param name Description

Param name	Description
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-06 01:07:17 +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.

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-06 01:07:17 +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 PUT 'https://[your-subdomain].trackdrive.com/api/v1/scheduled_callbacks/10001' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "connect_with": "anyone",
  "place_call_at": "2027-06-16 10:00:00",
  "place_call_time_zone": "Eastern Time (US & Canada)"
}'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "scheduled_callback": {
    "id": 10001,
    "type": "ScheduledCallback",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "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/10001",
    "routes_edit_path": "/scheduled_callbacks/10001/edit",
    "external_record_id": null,
    "company_id": 10002,
    "lead_id": "a09e6bca-255b-4217-af73-cb9601c80217",
    "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": 10003,
    "offer_id": 10004,
    "connect_with_buyer_id": null,
    "recent_call_ids": [],
    "caller_number": "+18005550187"
  },
  "metadata": {
    "root": "scheduled_callback"
  }
}

DELETE /scheduled_callbacks/:id

Authorization Required

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

Delete a Scheduled Callback by ID

Deletes a Scheduled Callback, canceling the future call. Requires agent or superuser access, or the request is rejected.

Example Request

curl -X DELETE 'https://[your-subdomain].trackdrive.com/api/v1/scheduled_callbacks/10001' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 204