Sets the broker on this loan file, replacing whichever broker is on it
now. You'll get a 422 if the broker you name is not an active broker
on your account.
Send null to unassign: {"brokerId": null} takes the broker off
the loan file, and the reply is data: null, the same as reading the
broker back. Nobody is emailed, and a note records who was taken off.
A loan file with no broker is left exactly as it is. brokerId must
be in the body either way — leaving it out is a 422, so a client
that drops the field cannot clear the broker by accident. Only a JSON
null unassigns; "" or "null" is a 422.
Two other things are recorded at the same time. The broker is added to
the loan file's current branch as a preferred agent, if the broker is
not on it already, and a client referral is filed. You can send the
same broker twice safely — neither record is duplicated.
The broker is emailed, but only when the broker really changes and
has an email address on file. This is the same message the back office
sends. Sending the broker that is already on the loan file emails
nobody.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||

