Who This Is For / When to Use
Use this trigger if you want to automatically handle contacts whose phone numbers are invalid or unable to receive SMS, such as flagging records, notifying your team, or requesting an updated number.
What the Number Validation Trigger Does
The Number Validation trigger runs before an SMS is sent or a call is made.
If Kyrios receives a validation error from the number validation service, the contact that caused the error is immediately added to the workflow.
This allows you to:
Prevent repeated delivery failures
Take corrective action on bad phone numbers
Notify internal users or update contact data automatically
Supported Validation Error Types
The trigger can activate on one or both of the following errors:
Not Valid – The phone number format or structure is invalid
SMS Incapable – The number cannot receive SMS messages
Step 1: Create or Open a Workflow
Navigate to Automations → Workflows.
Click Create Workflow, or open an existing workflow from the list.
Step 2: Add the Number Validation Trigger
In the workflow builder, click Add New Workflow Trigger.
From the trigger list, select Number Validation.
Step 3: Configure Trigger Filters
(Optional) Update the Workflow Trigger Name.
This only changes the label shown inside the workflow builder.Click Add filters.
Set the Number is filter to one or both:
Not Valid
SMS Incapable
Only contacts whose number matches the selected error types will enter the workflow.
Step 4: Save the Trigger
Click Save Trigger in the bottom-right corner of the trigger panel.
Step 5: Add Workflow Actions (Optional)
You can attach any workflow actions after the Number Validation trigger, including:
Updating contact fields
Applying tags
Sending internal notifications
Assigning tasks
Requesting updated contact information
The trigger works even if no actions are added.
Step 6: Publish and Test the Workflow
Click Save in the top-right of the workflow builder.
Toggle the workflow status from Draft to Publish.
Click Test Workflow to confirm expected behavior.
Common Issues and Fixes
Workflow does not trigger
Confirm the workflow is Published, not Draft.
Verify the phone number actually returns a Not Valid or SMS Incapable error.
Ensure filters are not excluding the contact.
Contacts are not re-entering the workflow
Contacts exit the workflow after completing all actions.
If the same contact later triggers another number validation error, they are added again automatically.
FAQs
What validation errors can trigger this workflow?
You can trigger on Not Valid, SMS Incapable, or both.
Can I limit which contacts enter the workflow?
Yes. You can add additional filters (such as custom fields) so only contacts matching your criteria are added.
Do I need workflow actions for this trigger to work?
No. The trigger can run without actions, but adding actions is recommended for visibility or remediation.
What happens if a contact later updates their phone number?
If the updated number fails validation again in a future SMS or call attempt, the contact is re-added to the workflow.