I'm not in love with a change in return types. Could a new method be added that returns the ID, then this method could just become a wrapper for that, returning a bool based on success? It'd preserve the behavior while letting people opt-in to the new/better behavior if they'd like. The docstring should be changed to recommend that method if so.