---
title: "Create Internal Text Message"
method: POST
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/company-pager"
tags: ["Pager Messages"]
---

# Create Internal Text Message

`POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/company-pager`

Creates and sends an internal text message (company pager message).

## Path parameters

- `accountId` string, required
- `extensionId` string, required

## Request body

- CreateInternalTextMessageRequest
  - `from` PagerCallerInfoRequest — Sender of a pager message.
    - `extensionId` string — Extension identifier
    - `extensionNumber` string — Extension number
  - `replyOn` integer — Internal identifier of a message this message replies to
  - `text` string, required — Text of a pager message. Max length is 1024 symbols (2-byte UTF-16 encoded). If a character is encoded in 4 bytes in UTF-16 it is treated as 2 characters, thus restricting the maximum message length to 512 symbols
  - `to` PagerCallerInfoRequest[] — Optional if `replyOn` parameter is specified. Receiver of a pager message.
    - `extensionId` string — Extension identifier
    - `extensionNumber` string — Extension number

## Response `200`

Created text message

- GetInternalTextMessageInfoResponse
  - `id` integer — Internal identifier of a message
  - `uri` string, uri — Canonical URI of a message
  - `attachments` MessageAttachmentInfo[] — The list of message attachments
    - `id` integer — Internal identifier of a message attachment
    - `uri` string, uri — Canonical URI of a message attachment
    - `type` 'AudioRecording' | 'AudioTranscription' | 'Text' | 'SourceDocument' | 'RenderedDocument' | 'MmsAttachment' — Type of message attachment
    - `contentType` string — MIME type for a given attachment, for instance 'audio/wav'
    - `vmDuration` integer — Supported for `Voicemail` only. Duration of a voicemail in seconds
    - `fileName` string — Name of a file attached
    - `size` integer — Size of attachment in bytes
    - `height` integer — Attachment height in pixels if available
    - `width` integer — Attachment width in pixels if available
  - `availability` 'Alive' | 'Deleted' | 'Purged' — Message availability status. Message in 'Deleted' state is still preserved with all its attachments and can be restored. 'Purged' means that all attachments are already deleted and the message itself is about to be physically deleted shortly
  - `conversationId` integer — SMS and Pager only. Identifier of a conversation that the message belongs to
  - `conversation` ConversationInfo — SMS and Pager only. Information about a conversation the message belongs to
    - `id` string — Internal identifier of a conversation
    - `uri` string, uri — Deprecated. Link to a conversation resource
  - `creationTime` string, date-time — Message creation date/time in ISO 8601 format including timezone, for example 2016-03-10T18:07:52.534Z
  - `direction` 'Inbound' | 'Outbound' — Text message direction. Note that for some message types not all directions are allowed. For example voicemail messages can be only inbound
  - `from` MessageStoreCallerInfoResponseFrom — Sender information
    - `extensionNumber` string — Extension short number (usually 3 or 4 digits). This property is filled when parties communicate by means of short internal numbers, for example when calling to other extension or sending/receiving Company Pager message
    - `extensionId` string — Internal identifier of an extension
    - `location` string — Contains party location (city, state) if one can be determined from phoneNumber. This property is filled only when phoneNumber is not empty and server can calculate location information from it (for example, this information is unavailable for US toll-free numbers)
    - `name` string — Symbolic name associated with a party. If the phone does not belong to the known extension, only the location is returned, the name is not determined then
    - `phoneNumber` string — Phone number of a party. Usually it is a plain number including country and area code like 18661234567. But sometimes it could be returned from database with some formatting applied, for example (866)123-4567. This property is filled in all cases where parties communicate by means of global phone numbers, for example when calling to direct numbers or sending/receiving SMS
  - `lastModifiedTime` string, date-time — Date/time when the message was modified on server in ISO 8601 format including timezone, for example 2016-03-10T18:07:52.534Z
  - `messageStatus` 'Queued' | 'Sent' | 'Delivered' | 'DeliveryFailed' | 'SendingFailed' | 'Received' — Message status. Different message types may have different allowed status values. For outbound faxes the aggregated message status is returned. If, for outbound message, a status for at least one recipient is 'Queued', then the 'Queued' value is returned. If a status for at least one recipient is 'SendingFailed', then the 'SendingFailed' value is returned. In other cases the 'Sent' status is returned
  - `pgToDepartment` boolean — Pager only. `true` if at least one of a message recipients is 'Department' extension
  - `priority` 'Normal' | 'High' — Message priority
  - `readStatus` 'Read' | 'Unread' — Message read status
  - `subject` string — Message subject. For SMS and Pager messages it replicates message text which is also returned as an attachment
  - `to` MessageStoreCallerInfoResponseTo[] — Recipient information
    - `extensionNumber` string — Extension short number (usually 3 or 4 digits). This property is filled when parties communicate by means of short internal numbers, for example when calling to other extension or sending/receiving Company Pager messages
    - `extensionId` string
    - `location` string — Contains party location (city, state) if one can be determined from a phone number. This property is filled only when `phoneNumber` is not empty and a server can calculate location information from it (for example, this information is unavailable for US toll-free numbers)
    - `target` boolean — The `true` value specifies that message is sent exactly to this recipient. Returned in the `to` field for group MMS. Useful if one extension has several phone numbers'
    - `messageStatus` 'Queued' | 'Sent' | 'Delivered' | 'DeliveryFailed' | 'SendingFailed' | 'Received' — Message status. Different message types may have different allowed status values. For outbound faxes the aggregated message status is returned. If, for outbound message, a status for at least one recipient is 'Queued', then the 'Queued' value is returned. If a status for at least one recipient is 'SendingFailed', then the 'SendingFailed' value is returned. In other cases the 'Sent' status is returned
    - `faxErrorCode` 'AllLinesInUse' | 'Undefined' | 'NoFaxSendPermission' | 'NoInternationalPermission' | 'NoFaxMachine' | 'NoAnswer' | 'LineBusy' | 'CallerHungUp' | 'NotEnoughCredits' | 'SentPartially' | 'InternationalCallingDisabled' | 'DestinationCountryDisabled' | 'UnknownCountryCode' | 'NotAccepted' | 'InvalidNumber' | 'CallDeclined' | 'TooManyCallsPerLine' | 'CallFailed' | 'RenderingFailed' | 'TooManyPages' | 'ReturnToDBQueue' | 'NoCallTime' | 'WrongNumber' | 'ProhibitedNumber' | 'InternalError' | 'FaxSendingProhibited' | 'ThePhoneIsBlacklisted' | 'UserNotFound' | 'ConvertError' | 'DBGeneralError' | 'SkypeBillingFailed' | 'AccountSuspended' | 'ProhibitedDestination' | 'InternationalDisabled'
    - `name` string — Symbolic name associated with a party. If the phone does not belong to the known extension, only the location is returned, the name is not determined then
    - `phoneNumber` string — Phone number of a party. Usually it is a plain number including country and area code like 18661234567. But sometimes it could be returned from database with some formatting applied, for example (866)123-4567. This property is filled in all cases where parties communicate by means of global phone numbers, for example when calling to direct numbers or sending/receiving SMS
    - `recipientId` string — Internal identifier of a message recipient
  - `type` 'Fax' | 'SMS' | 'VoiceMail' | 'Pager' | 'Text' — Message type

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)