Skip to main content

What It Does

  • Finds phone numbers for contacts using LinkedIn profile URLs.
  • Preserves all input columns while adding contact_phone_number and contact_phone_number_provider.
  • Supports template variables for flexible column mapping (e.g., @linkedin_profile).
  • Handles errors and retries automatically without stopping the workflow.
  • Credits are only consumed for successful enrichments (30 credits per phone number).

🏁 Getting Started

Waterfall Phone Enrichment config screenshot
1

Connect Input Data

Attach previous node output or S3 data containing LinkedIn profile URLs.
2

Map Person Reference

Select the LinkedIn URL column using template variables (e.g., @linkedin_profile).
3

Run Node

Execute the node in batches. Test Mode can be used for previewing a small subset.
4

Review Outputs

Access enriched phone numbers and provider info.

Inputs

πŸ› οΈ Required Fields

  • Person Reference (βœ…)
    LinkedIn URL for the contact (template variable or direct URL).
    Why it matters: Primary identifier for fetching phone numbers.

Output

  • Adds columns:
    contact_phone_number, contact_phone_number_provider
  • Preserves all original input columns.
  • Column conflicts are resolved with numeric suffixes (e.g., contact_phone_number_1).
✨ Failed rows do not stop processing; partial results are returned with detailed logging.

How It Works

  1. Validate settings and template variables.
  2. Load input data from S3 or previous node output.
  3. Resolve LinkedIn URL templates per row (@linkedin_profile).
  4. Send enrichment requests asynchronously in batches (default 100 rows).
  5. Receive phone numbers and map to original rows.
  6. Merge enriched data with input columns and handle column conflicts.

πŸš€ Example Use Cases & Prompts

Use CaseSetup Example
Enrich sales leadsUse @linkedin_profile to get direct phone numbers for outreach.
CRM cleanupFill missing phone numbers for existing contacts.
Multi-source validationCombine multiple identifiers to improve match accuracy.

✨ Pro Tips

  • Always include LinkedIn URL for each contact to improve enrichment success.
  • Test Mode can process a small subset before running full batch.
  • Rename output columns (PhoneNumber, Provider) for clarity in downstream reporting.

⚠️ Important Considerations

  • Credits are consumed per successful enrichment only (30 credits each).

πŸ›  Troubleshooting & Gotchas

SymptomLikely CauseQuick Fix
Blank contact_phone_numberLinkedIn URL missing or invalidVerify input column mapping
Missing input columnsTemplate variable does not existEnsure input DataFrame contains referenced column
Node stalls or slowsLarge batch or API rate limitingReduce batch size or split dataset into smaller chunks

πŸ“ FAQ

Yes β€” you can provide static URLs without template variables for individual contacts or testing.
The row remains in output with contact_phone_number empty. No credits are consumed.
Test Mode processes a small subset for fast validation without consuming full credits.

πŸ’° Pricing

ActionCredit Cost
Successful phone enrichment30 credits per phone
Credits are only charged when a phone number is successfully returned. Batch processing optimizes usage.

Drop this node into your Play to automatically enrich contacts with verified phone numbersβ€”efficiently and at scale. πŸš€