---
# @generated by sylphx-gen. Do not edit.
title: "Inbound messages"
description: "The `inbound_messages` collection of Sylphx Notify: The unified SMS and voice inbox, ordered by its resumable sequence."
type: reference
product: notifications
summary: "The unified SMS and voice inbox, ordered by its resumable sequence."
updated: 2026-09-28
order: 900
---

The unified SMS and voice inbox, ordered by its resumable sequence.

**Service** Sylphx Notify · **Resource type** `notify.sylphx.com/InboundMessage` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/sms_numbers/{sms_number}/inbound_messages/{inbound_message}` · **Shape** `record`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/envs/{env}/sms_numbers/{sms_number}/inbound_messages/{inbound_message}`. |
| `uid` | `string` | Stable identifier; existing SMS identifiers are preserved. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `sequence` | `int64` | The feed position, advancing when content changes within the environment; filter `sequence > N` to resume after the last one handled. Output only. |
| `carrier_message_id` | `string` | The carrier's id for this message; the dedupe key on the number binding. Output only. |
| `sender_number` | `string` | The sender, in E.164 when the carrier gave one. Output only. |
| `recipient_number` | `string` | The number the message was sent to, in E.164. Output only. |
| `text` | `string` | SMS text or the completed voicemail transcript. Empty after retention. Output only. |
| `segments` | `int32` | SMS segments; not applicable to voice. Output only. |
| `receive_time` | `timestamp` | When the carrier says it received the message. Output only. |
| `cleared` | `bool` | The text has been cleared by retention; the dedupe key stays. Output only. |
| `channel` | `string` | sms or voice. Output only. |
| `voice` | `VoiceMessage` | Call and recording metadata; present only for voice. Output only. |
| `expire_time` | `timestamp` | Deadline for recording and transcript deletion. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/inbound_messages#get) | Get one message in the unified SMS and voice inbox. |
| `GET` | [`list`](/docs/api/inbound_messages#list) | List SMS and voice messages in sequence order. The sequence advances when asynchronous content changes, so polling also observes completed transcripts. |
| `POST` | [`download`](/docs/api/inbound_messages#download) | Download retained voicemail bytes with the inbox's tenant/resource permission. |

## get

Get one message in the unified SMS and voice inbox.

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

## list

List SMS and voice messages in sequence order. The sequence advances when asynchronous content changes, so polling also observes completed transcripts.

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

## download

Download retained voicemail bytes with the inbox's tenant/resource permission.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/sms_numbers/sms-number/inbound_messages/inbound-message:download` · scope `notify:read` · effect `read` · [Request, response and examples](/docs/api/inbound_messages/download)