Phone-based entities follow the standard entity lifecycle. You never need to create a new entity when the customer later provides a name, government ID, or other details — simply run subsequent verifications against the same
ent_… ID.Prerequisites
- A Youverify account at cowork.youverify.co
- Your API secret key from the dashboard under Settings → API Keys
- Webhooks configured for
entity.createdandentity.risk_score_updatedevents (recommended)
Steps
Phone-based entity: quick reference
What’s next
- Deepen verification with Government ID onboarding
- Build a full tiered flow with Tiered KYC
- Configure webhooks to receive real-time risk and signal events
- Read the Entity 360 to understand all the data that accumulates on an entity record