Call Forwarding, Recording & Screening

All settings below are configured via PATCH /mobile_phone_numbers/{id}.

Call Forwarding

Set the call_forwarding object to route calls when the device is unavailable.

Type	Behavior
`unconditional`	All calls forward immediately — device never rings
`no_answer`	Forward after timeout (device rings first)
`busy`	Forward when line is in use

Forward to any number — landline, mobile, SIP connection, or Call Control application.

Call Recording

Set call_recording to record inbound, outbound, or both. Recordings are accessible through the standard Telnyx Recordings API — same storage, retrieval, and webhooks as Call Control recordings.

Inbound Call Screening

Inbound Call Screening automatically blocks or flags inbound calls based on caller reputation and SHAKEN/STIR attestation. The feature is free on any number.

How it works

Screening evaluates three factors:

Factor	Description
Number Reputation	Cross-references caller identity against CallerAPI, Nomorobo, and YouMail databases
Number Validation	Checks whether the originating number is valid and exists
SHAKEN/STIR Attestation	Validates Caller ID authenticity — screens calls with Attestation C (unauthenticated) or Invalid (certificate error)

Handling modes

Mode	Behavior
Flag	Call connects but displays “SPAM LIKELY” in the From and P-Asserted-ID headers. A custom SIP header carries the screening status for your routing logic.
Reject	Call is blocked at the network level and never reaches your infrastructure.

Enabling call screening

Log in to the Mission Control Portal.
Go to My Numbers, select a number, and click Edit.
Under the Voice tab, enable Inbound Call Screening and choose Flag or Reject.

You can also enable it via PATCH /mobile_phone_numbers/{id} by setting the inbound_call_screening field.

Webhook integration

Enable webhooks to receive the call_screening_result field in the call.initiated webhook payload.

Number reputation screening applies to US and Canada calls. SHAKEN/STIR screening applies to North America.

Other Settings

Setting	Description
`noise_suppression`	AI noise reduction for loud environments

Example

{
  "call_forwarding": {
    "forwarding_type": "no_answer",
    "forwarding_number": "+15551234567",
    "timeout_secs": 30
  },
  "call_recording": {
    "inbound": "enabled",
    "outbound": "disabled"
  },
  "noise_suppression": "enabled"
}

Overview

Configuration

For AI Agents

Call Forwarding, Recording & Screening

Call Forwarding

Call Recording

Inbound Call Screening

How it works

Handling modes

Enabling call screening

Webhook integration

Other Settings

Example

​Call Forwarding

​Call Recording

​Inbound Call Screening

​How it works

​Handling modes

​Enabling call screening

​Webhook integration

​Other Settings

​Example

Call Forwarding

Call Recording

Inbound Call Screening

How it works

Handling modes

Enabling call screening

Webhook integration

Other Settings

Example