SendGrid, a Colorado-based email delivery service, announced they are sunsetting two of their API endpoints this month. In a short email sent to their API consumers, Sendgrid stated that all API calls must now use a new base URL. They also directed developers to reference SendGrid’s new API documentation or to contact them through their attached email.
Here’s what SendGrid is doing right: by informing their developer consumers of impending changes, SendGrid is preserving their trust. In Mark Boyd’s article on API deprecation and versioning, he makes it clear that keeping developers “aware of upcoming breaking changes is considered one of the key signals of best practice in developer relations.” By acknowledging that developers depend on an API and it’s provider, providers can keep their developers engaged and receptive to future relationships.