Appwrite Messaging helps you communicate with your users through push notifications, emails, and SMS text messages. Sending personalized communication for marketing, updates, and realtime alerts can increase user engagement and retention. You can also use Appwrite Messaging to implement security checks and custom authentication flows.
You can find guides and examples on using the Messaging API in the Appwrite Messaging product pages.
Base URL
https://cloud.appwrite.io/v1
Create subscriber
Create a new subscriber.
Request
topicId requiredTopic ID. The topic ID to subscribe to.
subscriberId requiredSubscriber ID. Choose a custom Subscriber ID or a new Subscriber ID.
targetId requiredTarget ID. The target ID to link to the specified Topic ID.
Response
201
Endpoint
POST /messaging/topics/{topicId}/subscribers
Apple
import Appwrite
let client = Client()
.setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
.setProject("<YOUR_PROJECT_ID>") // Your project ID
let messaging = Messaging(client)
let subscriber = try await messaging.createSubscriber(
topicId: "<TOPIC_ID>",
subscriberId: "<SUBSCRIBER_ID>",
targetId: "<TARGET_ID>"
)
Delete subscriber
Delete a subscriber by its unique ID.
Request
topicId requiredTopic ID. The topic ID subscribed to.
subscriberId requiredSubscriber ID.
Response
204
Endpoint
DELETE /messaging/topics/{topicId}/subscribers/{subscriberId}
Apple
import Appwrite
let client = Client()
.setEndpoint("https://cloud.appwrite.io/v1") // Your API Endpoint
.setProject("<YOUR_PROJECT_ID>") // Your project ID
let messaging = Messaging(client)
let result = try await messaging.deleteSubscriber(
topicId: "<TOPIC_ID>",
subscriberId: "<SUBSCRIBER_ID>"
)