http://docs.mongodb.org/manual/reference/operator/update/setOnInsert/ says "only when using the upsert option to the update() operation performs an insert" with bold on "only". It also works with findAndModify update clauses in upsert mode.