feat(backend): Deprecate createSMSMessage

Author: Nikos Polykandriotis

.changeset/slimy-windows-grab.md

@@ -0,0 +1,12 @@
+---
+'@clerk/backend': minor
+---
+
+Deprecate `createSMSMessage` and `SMSMessageApi` from `clerkClient`.
+
+The equivalent `/sms_messages` Backend API endpoint will also be dropped in the future, since this feature will no longer be available for new instances.
+
+For a brief period it will still be accessible for instances that have used it in the past 7
+days (13-11-2023 to 20-11-2023).
+
+New instances will get a 403 forbidden response if they try to access it.

packages/backend/src/api/endpoints/SMSMessageApi.ts

@@ -8,7 +8,13 @@ type SMSParams = {
   message: string;
 };
 
+/**
+ * @deprecated This endpoint is no longer available and the function will be removed in the next major version.
+ */
 export class SMSMessageAPI extends AbstractAPI {
+  /**
+   * @deprecated This endpoint is no longer available and the function will be removed in the next major version.
+   */
   public async createSMSMessage(params: SMSParams) {
     return this.request<SMSMessage>({
       method: 'POST',