Use a predefined phone number on an RTB formula

Location: Targets/RTBs → Create RTB Formula → Predefined Phone Number
​Last Updated: September 15, 2026

---

📝 Overview

RTB formulas can be configured to use a predefined phone number instead of relying on a phone number returned by an API response.

Use this when the buyer’s ping does not return a phone number, or when every win should dial the same DID. This is a static B‑leg number, not a tracking‑number or analytics product.

---

⚙️ How the Predefined Phone Number Option Works

When enabled, the RTB execution flow skips phone mapping entirely and routes all calls to a fixed phone number defined in the RTB parameters.

Configuration Options

• ☑️ Use Predefined Phone Number (skip phone mapping)
  Enables fixed-number routing and disables phone mapping requirements.

• 📱 Predefined Phone Number
  Input field for entering the destination number in E.164 format
  ​*(Example: +15551234567)*

---

🧪 Behavior & Validation Rules

The system enforces clear validation rules based on your configuration:

• If Use Predefined Phone Number is unchecked:

  • Phone number mapping is required

  • RTB behavior remains unchanged

• If Use Predefined Phone Number is checked:

  • Phone mapping is skipped

  • Payout and duration mappings are still required — they come from the API response

🟦 Consistency: Backend services and RTB execution apply this setting uniformly to ensure reliable call routing.

---

🎯 Why This Matters

Some RTB APIs do not return a destination phone number, which can interrupt or block call delivery.

This option ensures calls continue to route successfully by allowing you to define a fixed destination number directly within the RTB configuration.

Do not use this as a “uniform tracking number.” If you need SIP instead of PSTN, use the formula’s SIP mapping — not this checkbox.

---

💡 Example Use Cases

• Partner RTB APIs that omit the phone field

• Testing or sandbox campaigns using a consistent test number

• Campaigns that require a uniform tracking number across all calls

---

🚀 Getting Started

1. Navigate to Targets/RTBs → Create RTB Formula

2. Open the Parameters section

3. Check Use Predefined Phone Number (skip phone mapping)

4. Enter the Predefined Phone Number in E.164 format

5. Save the RTB formula

✅ Map payout and duration from the API response, then save.