API documentation

POST /contact_imports

Authorization Required

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

Create Blacklist File.

Upload a file or paste a text blob of phone numbers to bulk block or unblock, as set by apply_block_or_unblock. The import is validated on save and then processed asynchronously.

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
description Optional Blank value allowed	A human readable description of this import. Must be a String

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.com/api/v1/contact_imports/' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Example Contact Import",
  "apply_block_or_unblock": "block",
  "select_import_type": "text_blob",
  "import_file_blob": "+18005550123"
}'

Example Response 201

{
  "status": 201,
  "success": true,
  "errors": {},
  "contact_import": {
    "id": 10001,
    "type": "ContactImport",
    "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": "/contact_imports/10001",
    "routes_edit_path": "/contact_imports/10001/edit",
    "external_record_id": null,
    "company_id": 10002,
    "user_id": 10003,
    "status": null,
    "data_maps_set": true,
    "name": "Example Contact Import",
    "import_file_url": null,
    "data_json": "{\"data_map_caller_id\":\"caller_id\"}",
    "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": "text_blob",
    "import_file_blob": "+18005550123",
    "description": null,
    "headers": null
  },
  "metadata": {
    "root": "contact_import"
  }
}