API documentation

GET /contact_imports/new

Authorization Required

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

Build Blacklist File with defaults.

Return a new, unsaved blacklist import pre-filled with defaults.

Params

Param name	Description
name Optional Blank value allowed	Name Must be a String
import_file Optional Blank value allowed	The file containing phone numbers to block or unblock, used when select_import_type is file. Must be a valid file upload.
apply_block_or_unblock Optional Blank value allowed	Apply Block Or Unblock Must be one of: `block`, `unblock`.
select_import_type Optional Blank value allowed	Upload Import File Or Text Must be one of: `file`, `text_blob`.
import_file_blob Optional Blank value allowed	Text Blob Must be a String
data_map_caller_id Optional Blank value allowed	The column header from your uploaded file that contains the phone numbers to block or unblock. Must be a String

Example Request

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

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "contact_import": {
    "id": null,
    "type": "ContactImport",
    "uuid": null,
    "created_at": null,
    "updated_at": null,
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/contact_imports/new",
    "routes_edit_path": "/contact_imports/new",
    "external_record_id": null,
    "company_id": 10001,
    "user_id": null,
    "status": null,
    "data_maps_set": null,
    "name": "Import by Demo Summit Performance Media person1@example.com at 2026-01-15 11:30:00 -0400",
    "import_file_url": null,
    "data_json": null,
    "error_message": null,
    "import_count": null,
    "total_count": null,
    "started_at": null,
    "stopped_at": null,
    "failed_at": null,
    "succeeded_at": null,
    "unblock_started_at": null,
    "unblock_finished_at": null,
    "apply_block_or_unblock": "block",
    "select_import_type": "file",
    "import_file_blob": null,
    "description": null,
    "headers": null
  },
  "metadata": {
    "root": "contact_import"
  }
}