Create embedded experience URL

Creates a magic link for an embedded experience that can be started by opening the returned URL in a webview.

Available embedded experiences

These are the embedded experiences currently available. Note the "Version" required for each—these change periodically as new major versions of these experiences are rolled out.

Experience nameVersionDescription
ONBOARDINGV2_0Worker-facing onboarding experience.
WORKER_HOMEV1_0Worker-facing "hub" experience, including navigation links to the other embedded component experiences.
PAYMENT_HISTORYV1_0Worker-facing payment history, including access to earning totals and PDF pay statements.
TAX_DOCUMENTSV1_0Worker-facing year end tax document access, including Form 1099 and Form W-2 (depending on worker classification).
PAYMENT_DEPOSITV1_0Worker-facing deposit management experience, including bank account information capture.
HOME_ADDRESSV1_0Worker-facing home address management experience.

Sessions expire quickly!

Embedded experience URLs have a limited lifetime for security, so you should only create a URL immediately before you use it, not in advance. The URL expires quickly, so this should be called immediately before presenting embedded experience in your UX.

Body Params
string

required if "externalWorkerId" is null

string

required if "workerId" is null

string
required

see "Handling events" in the Embed Implementation guide

string
enum
required
Allowed:
string
required

See above for which version identifier to use here.

experienceOptions
object

Options to customize the experience of specific components.

Response

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
text/plain