Ask HN: How do you notify API consumers of changes?

I was wondering how SaaS apps / enterprises notify consumers of your APIs of breaking changes / deprecation?

Is sending an email to the registered user account enough? Have some found that to be painful for consuming the exposed functionality?

Perhaps there is a convention for this sort of thing?