Audience: a MEMBER OF THE AUTHENTICATED TEAM (the team the token authorizes — with OAuth this can be a customer's team, not your own). Validate the authenticated team and return a Talentir URL where a team member completes KYB (Know Your Business) verification. The screen requires the visitor to sign in and be a member of that team; the sign-in code is pre-sent to the session creator's email.
/session/kybAudience: a MEMBER OF THE AUTHENTICATED TEAM (the team the token authorizes — with OAuth this can be a customer's team, not your own). Validate the authenticated team and return a Talentir URL where a team member completes KYB (Know Your Business) verification. The screen requires the visitor to sign in and be a member of that team; the sign-in code is pre-sent to the session creator's email.
Team API key generated from team settings. Sent as Authorization: Bearer <api_key>.
In: header
application/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
curl -X POST "https://example.com/session/kyb" \ -H "Content-Type: application/json" \ -d '{ "redirectUrl": "http://example.com" }'{ "url": "http://example.com"}Approval POST
Audience: a MEMBER OF THE AUTHENTICATED TEAM (the team the token authorizes — with OAuth this can be a customer's team, not your own). Validate pending payouts for that team and return a Talentir URL where a team member reviews and approves them. The screen requires the visitor to sign in and be a member of that team; the sign-in code is pre-sent to the session creator's email.
Allowance POST
Audience: the OWNER of the authenticated team (the team the token authorizes — with OAuth this can be a customer's team, not your own). Returns a Talentir URL where the team owner sets or edits the daily spending allowance for automatic payouts. The screen requires the visitor to sign in and be the team owner; the sign-in code is pre-sent to the session creator's email.
URL the user is returned to after completing or leaving the Talentir screen.
uriWhose branding the hosted session screen carries. talentir (default): Talentir branding on the main host. team: the authenticated team's white-label subdomain and logo — requires that team's white-label feature. platform: the subdomain and logo of the team operating the calling OAuth client — OAuth-authenticated calls only, requires the operating team's white-label feature. Sandbox and preview hosts keep their current origin and carry the verified brand in a signed token.
"talentir"Value in
Overrides who the one-time sign-in code is pre-sent to (default: the session creator's email). A hint only — the KYB screen still requires the signed-in user to be a member of the team, and any member can switch to their own email.
email