Updates and Idempotency

The /onboarding/ endpoint is safe to call multiple times for the same user. Here is exactly what gets updated on repeat calls:

User (matched by student_id)

Field	On Create	On Update
email	Set	Updated
phone_number	Set	Updated
first_name	Set	Not updated
last_name	Set	Not updated
date_of_birth	Set	Not updated

Tenancy (matched by student_id + start_rent_date + payment_reference + address_1)

Field	On Create	On Update
end_rent_date	Set	Updated
amount	Set	Updated
frequency	Set	Updated
All other fields	Set	Not updated
agreement	Downloaded & stored	Not re-downloaded

KYC Documents

Behavior	Description
First call	KYC session and extra details (photo, ID docs) are created
Subsequent calls	Existing KYC data is not overwritten — returns the existing records

Note: If you need to update KYC documents or other immutable fields after the initial onboarding, contact [email protected].

---