# Onboarding links: the clinic lands under your platform, and the notification comes at signing

- Date: 2026-11-10
- Type: Non-breaking change
- Surface: /api/public
- What you need to do: Nothing.
- Address: https://developers.rivr.io/changelog/2026-11-10-onboarding-links-platform-and-signed

A clinic that signs through an onboarding link you created with `POST /api/public/onboarding-links` no longer picks a journal system in Rivr's flow: it ends up under your platform. In three cases it still picks for itself: a dormant clinic that is reactivated and already stands under another system or none, a clinic whose onboarding you got back from the platform portal instead of a new one, and a clinic whose link was created before Rivr switched off onboarding links for your platform. If `merchantId` isn't in `GET /api/public/merchants` after the signing, the clinic has ended up elsewhere. The `MerchantOnboarding` notification, for platforms where Rivr has set an address, now comes as `signed` with `merchantId` as soon as the agreement is signed, and nothing is sent before that. `opened` only comes when Rivr emails the link. The guide Connect a clinic from your system (/guides/onboarding-links) has the details. Polling `GET /api/public/onboarding-links/{id}` works as before.

