post https://{subdomain}.maptician.com/json/occupants/
This is a bulk operation that accepts an array of JSON formatted objects following the Occupant/User Schema. Each object may also contain an "action" parameter which may be "create", "update", "upsert", and "delete". If no action value is provided, "upsert" will be assumed.
- Create actions will only create the provided Occupant. If the Occupant is already in the system, the operation will fail.
- Update actions will only update the specified Occupant. If the Occupant is not in the system already, the operation will fail.
- Upsert action will create the Occupant if one isn't in the system, and will update the Occupant if it already exists. Existing Occupants are matched either by userID or email fields, with first preference given to userID. For updates, any Occupant parameter that isn't asserted in the object is assumed to remain at its current value. Any parameter which has been provided with a null value will empty or reset the value if permitted.
- Delete actions will mark the Occupant as having been deleted (soft-delete only)