ActionTwilioUpdated September 2026
How do I look up a phone number with Twilio?
Short answer: You can lookup phone number in Twilio by hand from its own interface, but it won’t repeat itself. On TinyCommand, add the Twilio Lookup Phone Number action to a workflow, map its 2 inputs from any upstream app, and it runs automatically every time the trigger fires. No code, and a free tier to start.
Inputs
The fields this action accepts.
Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.
| Field | Type | Required | Description |
|---|---|---|---|
Phone Number phone_number | string | Required | E.164 format |
Lookup Type fields | options | Optional | Lookup Type. Options: Line Type (mobile/landline/VoIP), Caller Name (CNAM), Validation |
Sample request
{"phone_number": "+15551234567","fields": "{{trigger.fields}}"}
Returns
{"valid": true,"country_code": "US","phone_number": "+15551234567","national_format": "(555) 123-4567","calling_country_code": "1","line_type_intelligence": {"type": "mobile","carrier_name": "T-Mobile"}}
Use these fields in downstream nodes for routing, logging, or error handling.
Triggered by
Apps that pair well as the trigger for Lookup Phone Number.
Any of these apps can fire this action as part of a workflow.
FAQ
Questions about Lookup Phone Number.
What does the Lookup Phone Number action do in Twilio?
Looks up information about a phone number via Twilio Lookup: country, carrier, line type (mobile/landline/voip), and validity. Use to filter signups, fraud-score, or pre-validate before sending SMS.
What inputs does Lookup Phone Number require?
Required: Phone Number. Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if Twilio returns an error?
The run history shows the failed step with its input and the error message Twilio returned, so you can fix the input and run the workflow again. Automatic retries are built into HTTP steps only, where you can also set your own retry count and delay.
Does Lookup Phone Number support batch operations?
Run Lookup Phone Number inside a loop to process each item in an array. TinyCommand does not throttle calls for you, so for large arrays add a Delay step if you need to stay within Twilio's rate limits.
More actions
Other Twilio actions.
Action
Get Call
Retrieves details about a specific Twilio call by SID: from, to, duration, status, price, and recording info. Used to read back details after a webhook fires.
ActionGet Message
Retrieves details of a sent Twilio message by SID with status (queued, sent, delivered, undelivered, failed), price, and error code. Used to reconcile sends with carrier-reported state.
ActionList Calls
Lists call records from your Twilio account with filters for to, from, status, and date range. Used for usage reports, billing reconciliation, or quality monitoring.
ActionList Messages
Retrieves a list of sent and received messages on your Twilio account, with filters for to, from, status, and date sent. Used for audit and reporting.
ActionMake Call
Initiates an outbound phone call via Twilio. The call flow is driven by either a TwiML URL or by passing inline TwiML; required to specify either url or twiml.
ActionSend SMS
Sends an SMS (or MMS, by adding MediaUrl) via Twilio to the destination number. US/Canada destinations require 10DLC or short-code registration to avoid carrier filtering.