Developer accounts & sign-in

The Developer Portal at https://dev.valyd.work has two ways in — there is no password:

Magic link (email). Enter your email; Valyd sends a one-time sign-in link. Opening it signs you in. This is the usual path for owners, admins and developers.
Face — “Connect with Valyd”. If your account has a verified Valyd identity linked, you can sign in with your face (the same OAuth/OIDC “Connect with Valyd” flow your own app uses).

Workforce members (the people your organization onboards to use your apps, not build them) do not use either of the above — they activate and sign in by face only, from an invite. See Organizations & teams.

Which one should I use?

Just getting started, or no Valyd identity yet → magic link.
You want faster, phishing-resistant sign-in → link your face (below), then use Connect with Valyd.

Connect your Valyd ID

An account created by magic link starts as email-only. You can attach a Valyd face identity to it at any time so you can sign in by face and prove who you are:

Sign in (magic link) and open Profile.
Under your identity, choose Connect your Valyd ID.
Complete Connect with Valyd (face). The returned identity is linked to your current, already signed-in account.

Notes:

Linking requires an authenticated session by design — you connect a face to the account you are already signed in to. You cannot link a face to an account you are not signed in to.
This is different from Connected apps on an end-user’s Valyd account (the third-party sites a user authorized via Connect with Valyd). Developer “Connect your Valyd ID” links your own face to your own console account.

One person, multiple accounts

A single Valyd identity (your face) can own several Developer Portal accounts — most commonly one account per company you work with. Valyd keeps them separate but lets you move between them without signing in again.

When it appears: if your email or face maps to more than one account, sign-in shows an account picker — choose which account to enter.
Switching later: use Switch account (/switch) in the portal to hop between the accounts your identity already owns. No re-scan, no new magic link.
What stays separate per account: projects/apps (client_id/client_secret), Verify workflows and API keys, billing, team and members. Switching accounts changes all of these.

At the identity layer, a person is still one face = one Valyd identity. “Multiple accounts” is a Developer Portal concept: the one identity is the owner of multiple console tenants. (To use that one identity across multiple devices, pair each device — see device pairing. That extends the same identity to another device; it does not create another account.)

Projects live under an organization

Everything you build lives inside an organization — there is no separate “personal vs organization app” split. On first sign-in Valyd creates your personal organization automatically: an org of one that can’t be deleted. Every project (a “Connect with Valyd” app with its own verification) belongs to whichever organization is active in the sidebar switcher:

Your personal organization — your solo workspace. Its projects and its bill are yours.
Team organizations — shared tenants you create or are invited to. Projects, members and the per-seat bill belong to the org, and ownership stays with it even when a person leaves. Access is role-gated: owner / admin manage everything, developers build with the keys, and members are read-only and can’t see projects.

Switch between the organizations you own or joined from the org dropdown at the top of the sidebar. Billing is a flat $0.99 per active member, drawn from the organization’s prepaid balance.

See Organizations & teams for roles, the face-verified workforce, and the Members API.

Managing your developer account

Rotate a client secret: open the app in the portal and use Rotate secret on its credentials. The old secret stops working immediately, so deploy the new one first.
Delete your developer account: Profile → danger zone. Deleting cascades to the apps you own; other console accounts your identity also owns are kept and simply unlinked.

Common questions

“What’s my password?” — There isn’t one. Use the magic link, or face if you’ve linked it.
“I got an account picker I didn’t expect.” — Your email/identity owns more than one account. Pick the right company; use Switch account later to change.
“Can I automate portal login for CI?” — No. Sign-in, linking and switching are human portal steps. For server-to-server automation use an app’s client_id/client_secret (Connect with Valyd) or an app’s API key (Verification APIs) — not a portal login.