Explore 7 workflow actions for Telnyx, including account permissions and operation limits.
6 read actions1 write action
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Get message
Read
Read the message and each recipient's provider-reported delivery status.
Permissions and limits
Account permissions
API key with messaging read access
Operation limits
Telnyx only retrieves messages created within the last 10 days through this endpoint. Failed delivery status and message-level error details are returned as reported by Telnyx.
Get messaging profile
Read
Read a messaging profile's enabled state and sending limits without webhook secrets.
Permissions and limits
Account permissions
API key with messaging read access
Get phone number
Read
Read the selected owned number's status and messaging assignment, excluding porting PINs.
Permissions and limits
Account permissions
API key with phone-number read access
List messaging profiles
Read
Read a page of messaging profiles without exposing webhook secrets.
Permissions and limits
Account permissions
API key with messaging read access
Pagination: page. Check the result for additional pages; a single action may not return every record.
List phone numbers
Read
Read a page of owned numbers and their messaging-profile assignments.
Permissions and limits
Account permissions
API key with phone-number read access
Pagination: page. Check the result for additional pages; a single action may not return every record.
List profile numbers
Read
Read a page of numbers assigned to one messaging profile.
Permissions and limits
Account permissions
API key with messaging read access
Pagination: page. Check the result for additional pages; a single action may not return every record.
Send SMS
Write
Submit one text message and return Telnyx's actual per-recipient status.
Permissions and limits
Account permissions
API key allowed to send messages from the selected sender
Operation limits
Requires an authorized E.164 sender and any applicable Telnyx messaging registration. Queued or sent does not mean delivered. Use Get message for delivery status. This operation does not automatically retry a dispatched send.
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Telnyx. A saved workflow is not a completed provider action.