create_tracker
Provision a new call tracking phone number for a company, routing calls to a destination number. Supports local or toll-free numbers, source or session types, and optional features like call recording and SMS.
Instructions
⚠️ Create a new tracking phone number (tracker). THIS COSTS MONEY.
CallRail charges per provisioned number — typical pricing as of 2026:
Local numbers: ~$3/month each
Toll-free (8XX): ~$3-5/month each
Session pools: charged per number × pool_size (so pool_size=8 = 8x)
Plus per-minute usage (~$0.05/min on answered calls)
Most plans bundle 5–10 numbers; provisioning beyond your bundle adds overage charges. Some plans prorate partial-month usage, so creating and immediately deleting can still produce a small charge depending on your contract.
You must pass confirm_billing=True to actually create. This guards
against accidental provisioning when an AI is exploring tools.
Args:
name: Display name for the tracker (e.g. "Google Ads Call Extension").
company_id: 'COM...' id of the company this tracker belongs to.
destination_number: Where calls forward to, e.g. "+14129548337".
confirm_billing: REQUIRED — set True to acknowledge the per-number
cost. Returns an error envelope if False (default).
type: 'source' (single number tied to one traffic source) or 'session'
(DNI pool that swaps numbers per visitor). Default 'source'.
source_type: For type='source', which traffic source. Must be one of:
'all', 'direct', 'offline', 'google_my_business',
'google_ad_extension' (this is what Google Ads call-extension uses).
Ignored for type='session' (use 'all').
area_code: 3-digit area code to provision the local number from
(e.g. '412'). Ignored if toll_free=True.
toll_free: If True, provision an 8XX toll-free number instead.
pool_size: For type='session' only — how many numbers in the DNI pool
(CallRail's "pool_size" required field). Typical 4-10. Each pool
number is billed separately.
whisper_message: Spoken to the agent answering the call so they know
which marketing source it came from.
recording_enabled: Record the call audio. Default True.
greeting_text: Optional automated greeting text-to-speech.
sms_enabled: Allow this number to receive/send SMS. Default True.
account_id: Auto-resolves if omitted.
Returns the created tracker including its newly-provisioned tracking_numbers.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| type | No | source | |
| area_code | No | ||
| pool_size | No | ||
| toll_free | No | ||
| account_id | No | ||
| company_id | Yes | ||
| sms_enabled | No | ||
| source_type | No | all | |
| greeting_text | No | ||
| confirm_billing | No | ||
| whisper_message | No | ||
| recording_enabled | No | ||
| destination_number | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |