API documentation

POST /virtual_numbers

Authorization Required

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

Create Virtual Number.

Create a virtual number and assign it to an offer, ring pool, or traffic source. Trackdrive generates the underlying dialable number for it asynchronously after creation.

Params

Param name	Description
number Required	Number Must be a String
offer_id Required	Refer to the offer api for details Must be a valid foreign key reference to an Offer. Refer to: /api/docs/1.0/offers
ring_pool_id Optional Blank value allowed	Refer to the Number Pool api for details Must be a valid foreign key reference to an Number Pool. Refer to: /api/docs/1.0/ring_pools
traffic_source_id Optional Blank value allowed	Refer to the traffic source api for details Must be a valid foreign key reference to an Traffic Source. Refer to: /api/docs/1.0/traffic_sources
description Optional Blank value allowed	Translation missing: en.api.description Must be a String

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.com/api/v1/virtual_numbers/' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "number": "+18005550188",
  "offer_id": 10001
}'

Example Response 201

{
  "status": 201,
  "success": true,
  "errors": {},
  "virtual_number": {
    "id": 10002,
    "type": "VirtualNumber",
    "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": "/virtual_numbers/10002",
    "routes_edit_path": "/virtual_numbers/10002/edit",
    "external_record_id": null,
    "name": "+18005550188",
    "description": null,
    "context_menu_name": "+18005550188",
    "company_id": 10003,
    "number": "+18005550188",
    "trackdrive_number_id": 10004
  },
  "metadata": {
    "root": "virtual_number"
  }
}