Messaging

CLIENT

Platform

Version

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 string
  required
  
  Topic ID. The topic ID to subscribe to.
- subscriberId string
  required
  
  Subscriber ID. Choose a custom Subscriber ID or a new Subscriber ID.
- targetId string
  required
  
  Target ID. The target ID to link to the specified Topic ID.
Response
- 201 application/json
  
  Subscriber

Endpoint

POST /messaging/topics/{topicId}/subscribers

GraphQL

mutation {
    messagingCreateSubscriber(
        topicId: "<TOPIC_ID>",
        subscriberId: "<SUBSCRIBER_ID>",
        targetId: "<TARGET_ID>"
    ) {
        _id
        _createdAt
        _updatedAt
        targetId
        target {
            _id
            _createdAt
            _updatedAt
            name
            userId
            providerId
            providerType
            identifier
        }
        userId
        userName
        topicId
        providerType
    }
}

Delete subscriber

Delete a subscriber by its unique ID.

Request
- topicId string
  required
  
  Topic ID. The topic ID subscribed to.
- subscriberId string
  required
  
  Subscriber ID.
Response
- 204 application/json

Endpoint

DELETE /messaging/topics/{topicId}/subscribers/{subscriberId}

GraphQL

mutation {
    messagingDeleteSubscriber(
        topicId: "<TOPIC_ID>",
        subscriberId: "<SUBSCRIBER_ID>"
    ) {
        status
    }
}

Recommended