---
# @generated by sylphx-gen. Do not edit.
title: "sylphx notify phone_numbers"
description: "The sylphx notify phone_numbers commands of Sylphx Notify: every verb, with its argument, its flags and a run line."
type: reference
product: notifications
summary: "Every sylphx notify phone_numbers command: its argument, its flags and a run line."
updated: 2026-09-28
nav: false
---

The `phone_numbers` commands of Sylphx Notify, as the CLI spells them: the same
calls as [the `phone_numbers` API page](/docs/api/phone_numbers), typed for the
shell. [Install, sign in and the grammar](/docs/cli) are on the CLI index.

## connect

ConnectPhoneNumber: existing provider-managed lines; execution credentials are transient.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx notify phone-numbers connect orgs/acme/projects/shop/envs/production
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/phone_numbers:connect` · scope `notify:write` · effect `write` · [Request, response and examples](/docs/api/phone_numbers/connect)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--phone-number-id` | `string` | Stable caller-chosen id; retries reuse this id. Required. |
| `--phone-number` | `string` | Existing E.164 number. Required. |
| `--provider-session-token` | `string` | Existing provider session, held only for this synchronous request. Never stored, logged, included in command hashes, or refreshed. Issuer lifetime is provider-owned; transient custody does not assert a shorter lifetime. Required. The value is never returned. |
| `--dry-run` | `bool` | Validate and print the result without writing (validate_only). |

## get

GetPhoneNumber: existing provider-managed lines; execution credentials are transient.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx notify phone-numbers get orgs/acme/projects/shop/envs/production/phone_numbers/phone-number
```

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/phone_numbers/phone-number` · scope `notify:read` · effect `read` · [Request, response and examples](/docs/api/phone_numbers/get)

## list

ListPhoneNumbers: existing provider-managed lines; execution credentials are transient.

**`PARENT`** — optional: the CLI fills it from the linked project or the
key's scope when it is left out.

**CLI**

```bash
sylphx notify phone-numbers list orgs/acme/projects/shop/envs/production
```

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/phone_numbers` · scope `notify:read` · effect `read` · [Request, response and examples](/docs/api/phone_numbers/list)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--page-size` | `int` | Page size, default 50, maximum 1000. |
| `--page-token` | `string` | Continuation token. |

## apply-route

ApplyPhoneNumberRoute: existing provider-managed lines; execution credentials are transient.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx notify phone-numbers apply-route orgs/acme/projects/shop/envs/production/phone_numbers/phone-number
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/phone_numbers/phone-number:applyRoute` · scope `notify:write` · effect `write` · [Request, response and examples](/docs/api/phone_numbers/apply_route)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--operation-id` | `string` | Stable logical operation id. A different route needs a different id. Required. |
| `--voicemail` | `json` | Desired voicemail settings. Required. |
| `--provider-session-token` | `string` | Transient provider session; excluded from every durable command/hash. Required. The value is never returned. |
| `--dry-run` | `bool` | Validate and print the result without writing (validate_only). |

## probe

ProbePhoneNumber: existing provider-managed lines; execution credentials are transient.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx notify phone-numbers probe orgs/acme/projects/shop/envs/production/phone_numbers/phone-number
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/phone_numbers/phone-number:probe` · scope `notify:write` · effect `write` · [Request, response and examples](/docs/api/phone_numbers/probe)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--start-day` | `string` | First provider-local calendar day, YYYY-MM-DD. Required. |
| `--end-day` | `string` | Last day inclusive; at most one day after start_day. Required. |
| `--provider-session-token` | `string` | Transient provider session. Required. The value is never returned. |

## read-voicemail

ReadPhoneNumberVoicemail: existing provider-managed lines; execution credentials are transient.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx notify phone-numbers read-voicemail orgs/acme/projects/shop/envs/production/phone_numbers/phone-number
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/phone_numbers/phone-number:readVoicemail` · scope `notify:read` · effect `read` · [Request, response and examples](/docs/api/phone_numbers/read_voicemail)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--provider-call-id` | `string` | Stable provider receipt id already held by this line. Required. |
| `--start-day` | `string` | Day window to re-establish receipt ownership. Required. |
| `--end-day` | `string` | Last day inclusive, at most one day after start_day. Required. |
| `--provider-session-token` | `string` | Transient provider session. Required. The value is never returned. |