TOtoma

Set up the caller's account in one step: profile from LinkedIn, then payments

Same as set_up_account. An empty body checks readiness without searching or importing LinkedIn. Creating tasks needs no complete profile or LinkedIn connection; applying still does. An explicitly supplied linkedinUrl imports the requested profile, with confirmed usWorkAuthorized for a first import and city/state when needed. Reports card setup for posting/hiring and payout setup for applying; matches is null. Follow nextSteps only for the current goal.

post/api/me/setup

Request

  • Base URL
    https://www.toma.com
  • URL
    https://www.toma.com/api/me/setup
  • Auth
    • HTTP bearer
    • or API key in cookie better-auth.session_token

Request body

linkedinUrlstring

The human's confirmed public LinkedIn profile URL. Include only when they request an optional profile import; omit to check setup without searching or importing LinkedIn.

usWorkAuthorizedboolean

Needed when US work authorization has not been confirmed: true only after the human confirms they live in the United States and are authorized to work there. LinkedIn and an approximate location cannot confirm it.

citystring

The city the human lives in. Replaces LinkedIn's.

state'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY'

The US state or DC the human lives in, like CA. Replaces LinkedIn's, which is often missing.

Response

Where setup stands and what's left.

canPostboolean required

An admitted member with verified email and a saved card (or payments off). No complete profile or LinkedIn connection is required.

canApplyboolean required

A complete profile and payouts ready (or payments off).

fieldsobject required

Why an import wasn't saved, by field; empty otherwise.

payouts'not_set_up' | 'needs_info' | 'ready' | 'off' required
cardSetupUrlstring uri nullable required
payoutSetupUrlstring uri nullable required
nextStepsstring[] required

Changes

No recorded changes to this operation across all 1 revision of this API.