Improving the createEvent method and adding some defaults and docblock

non BC change - I changed the order of the method arguments as the createdAt variable is more likely to be optional