DocumentationAPI Reference
Help CenterAPI ChangelogOpenAPI SpecStatus
Documentation

Getting Started

Getting users to your Hosted Flow is as simple as giving them your hosted flow link, which can be found in the Integration Section of your Dashboard.

Directing to the flow

To start the hosted flow, link a user to /verify on Persona with the appropriate GET parameters. To test the hosted flow in your sandbox, use the sandbox host domain.

An example link is https://inquiry.withpersona.com/verify?template-id=tmpl_JAZjHuAT738Q63BdgCuEJQre
Swap the template ID with yours to create your hosted flow link.

Parameters

To include a parameter in your hosted flow link, add it to the end of the URL. For example, add an Environment to the above link by adding the environment parameter to the end.

Example URL for Template:
https://inquiry.withpersona.com/verify?template-id=tmpl_JAZjHuAT738Q63BdgCuEJQre

Example URL for Dynamic Flow Template Version (persona@4 or later):
https://inquiry.withpersona.com/verify?inquiry-template-version-id=itmplv_Y1vuHAGRB6DAyBnFdbr82u7N

Example URL for Template with optional fields:
https://inquiry.withpersona.com/verify?template-id=tmpl_JAZjHuAT738Q63BdgCuEJQre&environment=sandbox&reference-id=user_id1&language=ja&fields[name-first]=Jane

Example URL for resuming an existing inquiry:
https://inquiry.withpersona.com/verify?inquiry-id=inq_PDGZKPEASz266wmRcPbuwjPP&session-token=123456&redirect-uri=https://withpersona.com/done