> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rio.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboard new user

The process for onboarding a new user is very straightforward. All that needs to be done is to retrieve an onboarding link from Rio and have the user complete the form hosted on the link.

### Requirements to start the flow.

<CardGroup cols={2}>
  <Card title="Broker account" icon="user-lock">
    You must have a broker account ([Tutorial here](/quickstart#user-account-creation))
  </Card>

  <Card title="API key" icon="shield-keyhole">
    Have an API key ([Tutorial here](/quickstart#api-key-generation)).
  </Card>
</CardGroup>

<Note>A child user cannot create another user</Note>

### Recommended endpoints.

<Card title="Get the custom onboarding link" icon="square-code" href="/api-reference/onboardings/create-onboarding-by-link">
  Send the link to the user or display it as an iframe in your application. Once
  they complete the form, their user will be created and associated to yours
  (broker) as a child (broker customer).
</Card>

<Card title="Check onboarding status" icon="square-code" href="/api-reference/users/get-user">
  You can use the `userId` from the onboarding object to poll the user and get
  its onboarding status (or you can use our webhooks).
</Card>

<Note>
  **Disclaimer**: All technical documentation is subject to the terms and
  conditions, which apply supplementarily and take precedence over the
  documentation.
</Note>