API documentation

GET /ring_pools

Authorization Required

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

List Phone Number Pools.

Returns the phone number pools configured on the account, used for dynamic number insertion tracking on a traffic source or offer. Supports CSV export and standard filtering and pagination.

Params

Param name	Description
ids Optional	Return records matching these ids. Must be an array of decimal values. EG: `[0, 1, 2, 3]`
page Optional	Return the next page of results. Must be a number.
per_page Optional	How many results to return per page. The default is 25. Must be a number.
created_at_to Optional	Date formatted like 2016-01-01 12:25:15 -0500 Must be a String
created_at_from Optional	Date formatted like 2016-01-01 12:25:15 -0500 Must be a String
fulltext Optional	Search for any record that matches this text Must be a String
time_zone Optional	Date ranges will be parsed using this time zone. Must be a valid time zone. See the list of valid time zones.
columns Optional	Specify the columns you would like returned by the API for a given resource. Limiting the columns can significantly increase API response time since only the requested data will be processed. columns=uuid,number,created_at Must be any combination of: id legacy_id type uuid created_at updated_at deleted_at user_updated_at routes_show_path routes_edit_path external_record_id context_menu_name company_id offer_id traffic_source_id numbers_count toll_free country description number_limit number_stockpile traffic_source_override_lead_traffic_source per_visitor tracking_type extensions_length extensions_minimum extensions_maximum provider_configuration_id auto_rent_numbers is_active provider name record_token_additional_id record_token_additional_data_count record_token_additional_data Must be a String
root Optional	Pass `root=false` to return results without a root node and metadata. For example: `GET /api/v1/calls?root=false` will return `[call1, call2, call3]` While: `GET /api/v1/calls` will return `{calls: [call1, call2, call3], metadata: {}}` Must be a boolean value: 1, true, yes, on, 0, false, no, off

Example Request

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

Example Response 200

{
  "status": 200,
  "success": true,
  "ring_pools": [
    {
      "id": 10001,
      "type": "RingPool",
      "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": "2026-01-15T15:30:00.000Z",
      "routes_show_path": "/ring_pools/10001",
      "routes_edit_path": "/ring_pools/10001/edit",
      "external_record_id": "example-record-1",
      "context_menu_name": "Local Tracking Pool - Local numbers for per-session visitor tracking",
      "company_id": 10002,
      "offer_id": 10003,
      "traffic_source_id": 10004,
      "numbers_count": 0,
      "toll_free": false,
      "country": "US",
      "description": "Local numbers for per-session visitor tracking",
      "number_limit": 20,
      "number_stockpile": 1,
      "traffic_source_override_lead_traffic_source": null,
      "per_visitor": true,
      "tracking_type": null,
      "extensions_length": null,
      "extensions_minimum": null,
      "extensions_maximum": null,
      "provider_configuration_id": 10005,
      "auto_rent_numbers": false,
      "is_active": true,
      "provider": "trackdrive",
      "name": "Local Tracking Pool",
      "record_token_additional_id": null,
      "record_token_additional_data_count": 0,
      "record_token_additional_data": []
    },
    {
      "id": 10006,
      "type": "RingPool",
      "uuid": "a09e6bca-255b-4217-af73-cb9601c80217",
      "created_at": "2026-01-15T15:30:00.000Z",
      "updated_at": "2026-01-15T15:30:00.000Z",
      "deleted_at": null,
      "user_updated_at": "2026-01-15T15:30:00.000Z",
      "routes_show_path": "/ring_pools/10006",
      "routes_edit_path": "/ring_pools/10006/edit",
      "external_record_id": "example-record-1",
      "context_menu_name": "Toll-Free Tracking Pool - Toll-free numbers for inbound call campaigns",
      "company_id": 10002,
      "offer_id": 10007,
      "traffic_source_id": 10008,
      "numbers_count": 0,
      "toll_free": true,
      "country": "US",
      "description": "Toll-free numbers for inbound call campaigns",
      "number_limit": 10,
      "number_stockpile": 1,
      "traffic_source_override_lead_traffic_source": null,
      "per_visitor": false,
      "tracking_type": null,
      "extensions_length": null,
      "extensions_minimum": null,
      "extensions_maximum": null,
      "provider_configuration_id": 10005,
      "auto_rent_numbers": false,
      "is_active": true,
      "provider": "trackdrive",
      "name": "Toll-Free Tracking Pool",
      "record_token_additional_id": null,
      "record_token_additional_data_count": 0,
      "record_token_additional_data": []
    }
  ],
  "metadata": {
    "root": "ring_pools",
    "page": 1,
    "total_pages": 3,
    "per_page": 2,
    "total_count": 5,
    "next_cursor": 10009
  }
}

GET /ring_pools/new

Authorization Required

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

Build Phone Number Pool with defaults.

Returns a phone number pool built with default attributes for previewing available fields. It is not saved.

Params

Param name	Description
offer_id Optional Blank value allowed	Offer Must be a valid foreign key reference to an Offer. Refer to: /api/docs/1.0/offers
provider_configuration_id Optional Blank value allowed	Refer to the provider api for details Must be a valid foreign key reference to an Provider. Refer to: /api/docs/1.0/provider_configurations
traffic_source_id Optional Blank value allowed	Traffic Source Must be a valid foreign key reference to an Traffic Source. Refer to: /api/docs/1.0/traffic_sources
numbers_count Optional Blank value allowed	Numbers Count Must be a decimal number.
toll_free Optional Blank value allowed	Toll Free Must be a boolean value: 1, true, yes, on, 0, false, no, off
country Optional Blank value allowed	Country Must be a String
number_limit Optional Blank value allowed	Number Limit Must be a decimal number.
name Optional Blank value allowed	Name Must be a String
description Optional Blank value allowed	A human readable description of this Number Pool. Must be a String
external_record_id Optional Blank value allowed	Your own identifier for this Number Pool, used to correlate it with a record in an external system. Must be a String
is_active Optional Blank value allowed	Use this Number Pool for Dynamic Number Insertion. Only one Number Pool can be active per Offer and Traffic Source. Must be a boolean value: 1, true, yes, on, 0, false, no, off
per_visitor Optional Blank value allowed	Assign each website visitor their own number from the pool, so calls can be attributed to that visitor. Must be a boolean value: 1, true, yes, on, 0, false, no, off
token_hold_time Optional Blank value allowed	How many seconds a number stays assigned to a caller’s token before it can be reassigned. Must be a decimal number.
number_stockpile Optional Blank value allowed	How many numbers to keep in reserve, ready and unassigned, within this pool. Must be a decimal number.
auto_rent_numbers Optional Blank value allowed	Automatically purchase numbers up to the Number Limit as they are needed. Must be a boolean value: 1, true, yes, on, 0, false, no, off
area_code_id Optional Blank value allowed	The preferred area code to purchase numbers from when Auto Rent Numbers is enabled. Must be an 8-bit integer ID or a 128-bit UUID reference to an object on Trackdrive. Example ID: 289302820, Example UUID: 924c37d5-e70f-42ad-84c2-e85eb0c1bc21
hide_embedded_access Optional Blank value allowed	Prevent this Number Pool from being used for embedded Dynamic Number Insertion access on more than one Traffic Source per Offer. Must be a boolean value: 1, true, yes, on, 0, false, no, off
google_analytics Optional Blank value allowed	Track calls from this Number Pool with Google Analytics. Must be a boolean value: 1, true, yes, on, 0, false, no, off
google_analytics_account Optional Blank value allowed	Your Google Analytics account id used when Google Analytics is enabled. Must be a String
maximum_ping_time Optional Blank value allowed	The maximum number of seconds a browser will wait for a number to be returned before giving up. Must be a decimal number.
extensions_length Optional Blank value allowed	The number of digits used for extensions when Extensions are enabled on this Number Pool. Must be a decimal number.
extensions_minimum Optional Blank value allowed	The lowest extension number that can be assigned. Must be a decimal number.
extensions_maximum Optional Blank value allowed	The highest extension number that can be assigned. Must be a decimal number.
fill_pool Optional Blank value allowed	Immediately purchase numbers until this pool reaches its Number Limit. Must be a boolean value: 1, true, yes, on, 0, false, no, off
traffic_source_override_lead_traffic_source Optional Blank value allowed	Force calls placed to this Number Pool’s numbers to credit this pool’s Traffic Source, even when the lead’s Traffic Source is different. Must be a boolean value: 1, true, yes, on, 0, false, no, off
dial_with_area_codes Optional Blank value allowed	When placing outbound calls, prefer a number from the pool matching the consumer’s area code. If none is available, an area code match from area_code_maps or any toll free number in the pool is used instead. Must be a boolean value: 1, true, yes, on, 0, false, no, off
dial_with_any_state_area_code Optional Blank value allowed	When Dial With Area Codes is enabled and no matching area code is available, allow dialing with any area code in the consumer’s state. Must be a boolean value: 1, true, yes, on, 0, false, no, off
attribution_token_value_ids Optional Blank value allowed	The ids of the Token Values whose tokens will be additionally applied to calls handled by this Number Pool. Must be a valid array of integers. Each integer ID must be a valid foreign key reference to an Token Value. Refer to: /api/docs/1.0/token_values
record_token_additional_list Optional Blank value allowed	Assign additional tokens that will be applied to calls handled by this Number Pool by passing a comma separated string of key:value pairs. Must be a valid list of tokens. Example tokens: `buyer_interest:loan,another_token:value`
cid Optional Blank value allowed	Alternative to offer_id. Matches an Offer by your own external Offer identifier instead. Must be a String
afid Optional Blank value allowed	Alternative to traffic_source_id. Matches a Traffic Source by your own external Traffic Source identifier instead. Must be a String
number_type Optional Blank value allowed	The type of Number Pool, such as RingPool for phone tracking numbers or SmsNumberGroup for SMS sending numbers. Must be a String

Example Request

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

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "ring_pool": {
    "id": null,
    "type": "RingPool",
    "uuid": null,
    "created_at": null,
    "updated_at": null,
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/ring_pools/new",
    "routes_edit_path": "/ring_pools/new",
    "external_record_id": null,
    "context_menu_name": "Phone Numbers",
    "company_id": 10001,
    "offer_id": null,
    "traffic_source_id": null,
    "numbers_count": 0,
    "toll_free": true,
    "country": "US",
    "description": null,
    "number_limit": 10,
    "number_stockpile": 1,
    "traffic_source_override_lead_traffic_source": null,
    "per_visitor": false,
    "tracking_type": null,
    "extensions_length": null,
    "extensions_minimum": null,
    "extensions_maximum": null,
    "provider_configuration_id": null,
    "auto_rent_numbers": true,
    "is_active": null,
    "provider": null,
    "name": "Phone Numbers",
    "record_token_additional_id": null,
    "record_token_additional_data_count": 0,
    "record_token_additional_data": []
  },
  "metadata": {
    "root": "ring_pool"
  }
}

POST /ring_pools

Authorization Required

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

Create Phone Number Pool.

Creates a phone number pool tied to an offer and a telephone provider, from which Trackdrive allocates numbers for dynamic number insertion. Requires offer_id and provider_configuration_id, and requires the setup_system permission.

Params

Param name	Description
offer_id Required	Offer Must be a valid foreign key reference to an Offer. Refer to: /api/docs/1.0/offers
provider_configuration_id Required	Refer to the provider api for details Must be a valid foreign key reference to an Provider. Refer to: /api/docs/1.0/provider_configurations
traffic_source_id Optional Blank value allowed	Traffic Source Must be a valid foreign key reference to an Traffic Source. Refer to: /api/docs/1.0/traffic_sources
numbers_count Optional Blank value allowed	Numbers Count Must be a decimal number.
toll_free Optional Blank value allowed	Toll Free Must be a boolean value: 1, true, yes, on, 0, false, no, off
country Optional Blank value allowed	Country Must be a String
number_limit Optional Blank value allowed	Number Limit Must be a decimal number.
name Optional Blank value allowed	Name Must be a String
description Optional Blank value allowed	A human readable description of this Number Pool. Must be a String
external_record_id Optional Blank value allowed	Your own identifier for this Number Pool, used to correlate it with a record in an external system. Must be a String
is_active Optional Blank value allowed	Use this Number Pool for Dynamic Number Insertion. Only one Number Pool can be active per Offer and Traffic Source. Must be a boolean value: 1, true, yes, on, 0, false, no, off
per_visitor Optional Blank value allowed	Assign each website visitor their own number from the pool, so calls can be attributed to that visitor. Must be a boolean value: 1, true, yes, on, 0, false, no, off
token_hold_time Optional Blank value allowed	How many seconds a number stays assigned to a caller’s token before it can be reassigned. Must be a decimal number.
number_stockpile Optional Blank value allowed	How many numbers to keep in reserve, ready and unassigned, within this pool. Must be a decimal number.
auto_rent_numbers Optional Blank value allowed	Automatically purchase numbers up to the Number Limit as they are needed. Must be a boolean value: 1, true, yes, on, 0, false, no, off
area_code_id Optional Blank value allowed	The preferred area code to purchase numbers from when Auto Rent Numbers is enabled. Must be an 8-bit integer ID or a 128-bit UUID reference to an object on Trackdrive. Example ID: 289302820, Example UUID: 924c37d5-e70f-42ad-84c2-e85eb0c1bc21
hide_embedded_access Optional Blank value allowed	Prevent this Number Pool from being used for embedded Dynamic Number Insertion access on more than one Traffic Source per Offer. Must be a boolean value: 1, true, yes, on, 0, false, no, off
google_analytics Optional Blank value allowed	Track calls from this Number Pool with Google Analytics. Must be a boolean value: 1, true, yes, on, 0, false, no, off
google_analytics_account Optional Blank value allowed	Your Google Analytics account id used when Google Analytics is enabled. Must be a String
maximum_ping_time Optional Blank value allowed	The maximum number of seconds a browser will wait for a number to be returned before giving up. Must be a decimal number.
extensions_length Optional Blank value allowed	The number of digits used for extensions when Extensions are enabled on this Number Pool. Must be a decimal number.
extensions_minimum Optional Blank value allowed	The lowest extension number that can be assigned. Must be a decimal number.
extensions_maximum Optional Blank value allowed	The highest extension number that can be assigned. Must be a decimal number.
fill_pool Optional Blank value allowed	Immediately purchase numbers until this pool reaches its Number Limit. Must be a boolean value: 1, true, yes, on, 0, false, no, off
traffic_source_override_lead_traffic_source Optional Blank value allowed	Force calls placed to this Number Pool’s numbers to credit this pool’s Traffic Source, even when the lead’s Traffic Source is different. Must be a boolean value: 1, true, yes, on, 0, false, no, off
dial_with_area_codes Optional Blank value allowed	When placing outbound calls, prefer a number from the pool matching the consumer’s area code. If none is available, an area code match from area_code_maps or any toll free number in the pool is used instead. Must be a boolean value: 1, true, yes, on, 0, false, no, off
dial_with_any_state_area_code Optional Blank value allowed	When Dial With Area Codes is enabled and no matching area code is available, allow dialing with any area code in the consumer’s state. Must be a boolean value: 1, true, yes, on, 0, false, no, off
attribution_token_value_ids Optional Blank value allowed	The ids of the Token Values whose tokens will be additionally applied to calls handled by this Number Pool. Must be a valid array of integers. Each integer ID must be a valid foreign key reference to an Token Value. Refer to: /api/docs/1.0/token_values
record_token_additional_list Optional Blank value allowed	Assign additional tokens that will be applied to calls handled by this Number Pool by passing a comma separated string of key:value pairs. Must be a valid list of tokens. Example tokens: `buyer_interest:loan,another_token:value`
cid Optional Blank value allowed	Alternative to offer_id. Matches an Offer by your own external Offer identifier instead. Must be a String
afid Optional Blank value allowed	Alternative to traffic_source_id. Matches a Traffic Source by your own external Traffic Source identifier instead. Must be a String
number_type Optional Blank value allowed	The type of Number Pool, such as RingPool for phone tracking numbers or SmsNumberGroup for SMS sending numbers. Must be a String

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.com/api/v1/ring_pools/' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "offer_id": 10001,
  "provider_configuration_id": 10002,
  "traffic_source_id": 10003,
  "name": "Example Number Pool",
  "toll_free": false,
  "country": "US",
  "number_limit": 10,
  "auto_rent_numbers": false
}'

Example Response 201

{
  "status": 201,
  "success": true,
  "errors": {},
  "ring_pool": {
    "id": 10004,
    "type": "RingPool",
    "uuid": null,
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": "2026-01-15T15:30:00.000Z",
    "routes_show_path": "/ring_pools/10004",
    "routes_edit_path": "/ring_pools/10004/edit",
    "external_record_id": null,
    "context_menu_name": "Example Number Pool",
    "company_id": 10005,
    "offer_id": 10001,
    "traffic_source_id": 10003,
    "numbers_count": 0,
    "toll_free": false,
    "country": "US",
    "description": null,
    "number_limit": 10,
    "number_stockpile": 1,
    "traffic_source_override_lead_traffic_source": null,
    "per_visitor": false,
    "tracking_type": null,
    "extensions_length": null,
    "extensions_minimum": null,
    "extensions_maximum": null,
    "provider_configuration_id": 10002,
    "auto_rent_numbers": false,
    "is_active": true,
    "provider": "trackdrive",
    "name": "Example Number Pool",
    "record_token_additional_id": null,
    "record_token_additional_data_count": 0,
    "record_token_additional_data": []
  },
  "metadata": {
    "root": "ring_pool"
  }
}

GET /ring_pools/:id

Authorization Required

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

Get Phone Number Pool by id.

Returns a single phone number pool by id, including its size, country, and provider configuration. Requires the setup_system permission.

Example Request

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

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "ring_pool": {
    "id": 10001,
    "type": "RingPool",
    "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": "2026-01-15T15:30:00.000Z",
    "routes_show_path": "/ring_pools/10001",
    "routes_edit_path": "/ring_pools/10001/edit",
    "external_record_id": "example-record-1",
    "context_menu_name": "Local Tracking Pool - Local numbers for per-session visitor tracking",
    "company_id": 10002,
    "offer_id": 10003,
    "traffic_source_id": 10004,
    "numbers_count": 0,
    "toll_free": false,
    "country": "US",
    "description": "Local numbers for per-session visitor tracking",
    "number_limit": 20,
    "number_stockpile": 1,
    "traffic_source_override_lead_traffic_source": null,
    "per_visitor": true,
    "tracking_type": null,
    "extensions_length": null,
    "extensions_minimum": null,
    "extensions_maximum": null,
    "provider_configuration_id": 10005,
    "auto_rent_numbers": false,
    "is_active": true,
    "provider": "trackdrive",
    "name": "Local Tracking Pool",
    "record_token_additional_id": null,
    "record_token_additional_data_count": 0,
    "record_token_additional_data": []
  },
  "metadata": {
    "root": "ring_pool"
  }
}

PUT /ring_pools/:id

Authorization Required

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

Update Phone Number Pool by id.

Updates a phone number pool's offer, provider, size, or other tracking settings. Requires the setup_system permission.

Params

Param name	Description
offer_id Optional Blank value allowed	Offer Must be a valid foreign key reference to an Offer. Refer to: /api/docs/1.0/offers
provider_configuration_id Optional Blank value allowed	Refer to the provider api for details Must be a valid foreign key reference to an Provider. Refer to: /api/docs/1.0/provider_configurations
traffic_source_id Optional Blank value allowed	Traffic Source Must be a valid foreign key reference to an Traffic Source. Refer to: /api/docs/1.0/traffic_sources
numbers_count Optional Blank value allowed	Numbers Count Must be a decimal number.
toll_free Optional Blank value allowed	Toll Free Must be a boolean value: 1, true, yes, on, 0, false, no, off
country Optional Blank value allowed	Country Must be a String
number_limit Optional Blank value allowed	Number Limit Must be a decimal number.
name Optional Blank value allowed	Name Must be a String
description Optional Blank value allowed	A human readable description of this Number Pool. Must be a String
external_record_id Optional Blank value allowed	Your own identifier for this Number Pool, used to correlate it with a record in an external system. Must be a String
is_active Optional Blank value allowed	Use this Number Pool for Dynamic Number Insertion. Only one Number Pool can be active per Offer and Traffic Source. Must be a boolean value: 1, true, yes, on, 0, false, no, off
per_visitor Optional Blank value allowed	Assign each website visitor their own number from the pool, so calls can be attributed to that visitor. Must be a boolean value: 1, true, yes, on, 0, false, no, off
token_hold_time Optional Blank value allowed	How many seconds a number stays assigned to a caller’s token before it can be reassigned. Must be a decimal number.
number_stockpile Optional Blank value allowed	How many numbers to keep in reserve, ready and unassigned, within this pool. Must be a decimal number.
auto_rent_numbers Optional Blank value allowed	Automatically purchase numbers up to the Number Limit as they are needed. Must be a boolean value: 1, true, yes, on, 0, false, no, off
area_code_id Optional Blank value allowed	The preferred area code to purchase numbers from when Auto Rent Numbers is enabled. Must be an 8-bit integer ID or a 128-bit UUID reference to an object on Trackdrive. Example ID: 289302820, Example UUID: 924c37d5-e70f-42ad-84c2-e85eb0c1bc21
hide_embedded_access Optional Blank value allowed	Prevent this Number Pool from being used for embedded Dynamic Number Insertion access on more than one Traffic Source per Offer. Must be a boolean value: 1, true, yes, on, 0, false, no, off
google_analytics Optional Blank value allowed	Track calls from this Number Pool with Google Analytics. Must be a boolean value: 1, true, yes, on, 0, false, no, off
google_analytics_account Optional Blank value allowed	Your Google Analytics account id used when Google Analytics is enabled. Must be a String
maximum_ping_time Optional Blank value allowed	The maximum number of seconds a browser will wait for a number to be returned before giving up. Must be a decimal number.
extensions_length Optional Blank value allowed	The number of digits used for extensions when Extensions are enabled on this Number Pool. Must be a decimal number.
extensions_minimum Optional Blank value allowed	The lowest extension number that can be assigned. Must be a decimal number.
extensions_maximum Optional Blank value allowed	The highest extension number that can be assigned. Must be a decimal number.
fill_pool Optional Blank value allowed	Immediately purchase numbers until this pool reaches its Number Limit. Must be a boolean value: 1, true, yes, on, 0, false, no, off
traffic_source_override_lead_traffic_source Optional Blank value allowed	Force calls placed to this Number Pool’s numbers to credit this pool’s Traffic Source, even when the lead’s Traffic Source is different. Must be a boolean value: 1, true, yes, on, 0, false, no, off
dial_with_area_codes Optional Blank value allowed	When placing outbound calls, prefer a number from the pool matching the consumer’s area code. If none is available, an area code match from area_code_maps or any toll free number in the pool is used instead. Must be a boolean value: 1, true, yes, on, 0, false, no, off
dial_with_any_state_area_code Optional Blank value allowed	When Dial With Area Codes is enabled and no matching area code is available, allow dialing with any area code in the consumer’s state. Must be a boolean value: 1, true, yes, on, 0, false, no, off
attribution_token_value_ids Optional Blank value allowed	The ids of the Token Values whose tokens will be additionally applied to calls handled by this Number Pool. Must be a valid array of integers. Each integer ID must be a valid foreign key reference to an Token Value. Refer to: /api/docs/1.0/token_values
record_token_additional_list Optional Blank value allowed	Assign additional tokens that will be applied to calls handled by this Number Pool by passing a comma separated string of key:value pairs. Must be a valid list of tokens. Example tokens: `buyer_interest:loan,another_token:value`
cid Optional Blank value allowed	Alternative to offer_id. Matches an Offer by your own external Offer identifier instead. Must be a String
afid Optional Blank value allowed	Alternative to traffic_source_id. Matches a Traffic Source by your own external Traffic Source identifier instead. Must be a String
number_type Optional Blank value allowed	The type of Number Pool, such as RingPool for phone tracking numbers or SmsNumberGroup for SMS sending numbers. Must be a String

Example Request

curl -X PUT 'https://[your-subdomain].trackdrive.com/api/v1/ring_pools/10001' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Example Number Pool (renamed)"
}'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "ring_pool": {
    "id": 10001,
    "type": "RingPool",
    "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": "2026-01-15T15:30:00.000Z",
    "routes_show_path": "/ring_pools/10001",
    "routes_edit_path": "/ring_pools/10001/edit",
    "external_record_id": null,
    "context_menu_name": "Example Number Pool (renamed)",
    "company_id": 10002,
    "offer_id": 10003,
    "traffic_source_id": 10004,
    "numbers_count": 0,
    "toll_free": false,
    "country": "US",
    "description": null,
    "number_limit": 10,
    "number_stockpile": 1,
    "traffic_source_override_lead_traffic_source": null,
    "per_visitor": false,
    "tracking_type": null,
    "extensions_length": null,
    "extensions_minimum": null,
    "extensions_maximum": null,
    "provider_configuration_id": 10005,
    "auto_rent_numbers": false,
    "is_active": true,
    "provider": "trackdrive",
    "name": "Example Number Pool (renamed)",
    "record_token_additional_id": null,
    "record_token_additional_data_count": 0,
    "record_token_additional_data": []
  },
  "metadata": {
    "root": "ring_pool"
  }
}

DELETE /ring_pools/:id

Authorization Required

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

Destroy Phone Number Pool by id.

Permanently deletes a phone number pool. Requires the setup_system permission.

Example Request

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

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "ring_pool": {
    "id": 10001,
    "type": "RingPool",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": "2026-01-15T15:30:00.000Z",
    "user_updated_at": "2026-01-15T15:30:00.000Z",
    "routes_show_path": "/ring_pools/10001",
    "routes_edit_path": "/ring_pools/10001/edit",
    "external_record_id": null,
    "context_menu_name": "Example Number Pool",
    "company_id": 10002,
    "offer_id": 10003,
    "traffic_source_id": 10004,
    "numbers_count": 0,
    "toll_free": false,
    "country": "US",
    "description": null,
    "number_limit": 10,
    "number_stockpile": 1,
    "traffic_source_override_lead_traffic_source": null,
    "per_visitor": false,
    "tracking_type": null,
    "extensions_length": null,
    "extensions_minimum": null,
    "extensions_maximum": null,
    "provider_configuration_id": 10005,
    "auto_rent_numbers": false,
    "is_active": true,
    "provider": "trackdrive",
    "name": "Example Number Pool",
    "record_token_additional_id": null,
    "record_token_additional_data_count": 0,
    "record_token_additional_data": []
  },
  "metadata": {
    "root": "ring_pool"
  }
}

Params

Must be any combination of:

Params

Params

Params