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.

Lookup Phone Number in Twilio — start free
Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

FieldTypeRequiredDescription
Phone Number
phone_number
stringRequiredE.164 format
Lookup Type
fields
optionsOptionalLookup 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.

Lookup Phone Number in Twilio — start free