Skip to content

NF Find Phone Numbers

NF Find Phone Numbers scans one text value for dialable numbers. Use it for Notes, Description, email bodies, or chatter text in Flow. For a single known phone field, use NF Process Phone instead.

  1. On the canvas, click Add element (or the + on a connector).
  2. Choose Action. Flow Builder opens the New Action window.
  3. Set Filter By to Type, then select Apex Action.
  4. Search for NF Find Phone Numbers, select it, and click Done.
New Action modal with Apex Action filter and NF Find Phone Numbers search result
InputRequiredDescription
Text ValueYesText to scan
Default RegionNoISO region code used when a matched number has no + country code; blank uses NF.orgDefaultRegion
LeniencyNoVALID (default), POSSIBLE, STRICT_GROUPING, EXACT_GROUPING. Same as NF.Leniency.
Max TriesNoCap extraction work on very long strings
NF Find Phone Numbers action inputs with text value, default region, leniency, and max tries
OutputDescription
SuccessAction completed without execution error
Match CountNumber of matches found
Match ResultsCollection of match rows
Error MessageExecution failure (for example blank text)

Each Match Result row includes:

FieldDescription
Matched TextSubstring from source text
Start Index / End IndexZero-based positions
E164, International, National, RFC3966Formatted values
Region Code, Country Calling CodeParsed metadata
Number Type / Number Type DisplayLine type

Flow Builder lists the action-level outputs on the element. Store them automatically, then reference them in later elements.

NF Find Phone Numbers action outputs section listing Success, Match Count, Match Results, and Error Message

Example return values for Call +1 650-253-0000 or +1 212-555-0101 today. with Default Region US and Leniency VALID:

Screen flow showing NF Find Phone Numbers output values with two match results
ValueUse when
VALIDOnly well-formed numbers (default)
POSSIBLELooser length checks
STRICT_GROUPING / EXACT_GROUPINGHarsh punctuation rules on long documents

Matches NF.findNumbers overloads in the API reference.

NF Find Phone Numbers extracts matches from text only — it does not create or update records by itself. Add a Loop on {!Match Results} and your own elements to act on each match.

Example: record-triggered flow on Lead Update when {!$Record.Description} may contain dialable numbers:

  1. Run NF Find Phone Numbers on {!$Record.Description}.
  2. Loop through {!NF Find Phone Numbers.Match Results}.
  3. For each match, Update Records on the Lead — set Phone to {!Loop Matches.E164} (the last match in the loop wins if there are several).
Record-triggered Lead flow with NF Find Phone Numbers, loop on matches, and Update Lead Phone per match