Create an owner
Learn how to create an owner.
Owners represent the legal owners of units and are used to route payments collected on behalf of owners.
1. Create an owner
The minimum information required to create an owner is:
- Their
email. - The
business_type, which can be eithercompanyorindividual.
1
curl https://api.yorlet.com/v1/owners \
2
-H "Authorization: {{API_KEY}}" \
3
-H "Content-Type: application/json" \
4
-d '{
5
"email": "[email protected]",
6
"business_type": "individual"
7
}'
Copied!
If you want to pre-fill information, you can provide more details when creating the Owner. See the create an owner API for a full list of parameters you can send.
Step 2: Create an onboarding link
1
curl https://api.yorlet.com/v1/owners/{{OWNER_ID}}/onboarding \
2
-H "Authorization: {{API_KEY}}" \
3
-H "Content-Type: application/json" \
4
-d '{
5
"type": "owner_onboarding"
6
}'
Copied!
Step 3: Redirect to URL
The response includes a
url. Redirect to this link to send your user into the flow. URLs from the Onboarding Links are temporary and can only be used once because they grant access to the account holder’s personal information. Authenticate the user in your application before redirecting them to this URL.Step 4: User returns to your site
After the user completes the onboarding flow they will be redirected back to your site.
Step 5: Handle users that still require information
Check the Owner status and create another onboarding link to complete onboarding if needed.
Last modified 9mo ago