API documentation

POST /zip_code_list_files

Authorization Required

https://[your-subdomain].trackdrive.net/api/v1/zip_code_list_files

Create Zip CSV File.

Uploads a CSV file of zip codes (import_file) to append to an existing zip code list identified by zip_code_list_id. The file is parsed and imported.

Params

Param name	Description
zip_code_list_id Optional Blank value allowed	Zip Code List Must be a decimal number.
name Optional Blank value allowed	Name Must be a String
description Optional Blank value allowed	Description Must be a String
import_file Optional Blank value allowed	Import File Must be a valid file upload.

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.net/api/v1/zip_code_list_files/' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -F 'zip_code_list_id=10001' \
  -F 'name=Example Zip Code File' \
  -F 'import_file=@zip_codes.csv'

Example Response 201

{
  "status": 201,
  "success": true,
  "errors": {},
  "zip_code_list_file": {
    "id": 10002,
    "type": "ZipCodeListFile",
    "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": "/zip_code_list_files/10002",
    "routes_edit_path": "/zip_code_list_files/10002/edit",
    "external_record_id": null,
    "company_id": 10003,
    "zip_code_list_id": 10001,
    "name": "Example Zip Code File",
    "description": null,
    "import_file_url": "https://[your-subdomain].trackdrive.net/zip_code_list_file/10002/download/import_file",
    "zip_codes": null,
    "sortable_order": -2,
    "zip_codes_count": null,
    "started_at": null,
    "stopped_at": null,
    "succeeded_at": null,
    "failed_at": null
  },
  "metadata": {
    "root": "zip_code_list_file"
  }
}