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.
https://cloud.appwrite.io/v1
List messages
Get a list of all messages from the current Appwrite project.
Request
queries Array of query strings generated using the Query class provided by the SDK. Learn more about queries. Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: scheduledAt, deliveredAt, deliveredTotal, status, description, providerType
search Search term to filter your list results. Max length: 256 chars.
Response
200
GET /messaging/messages
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.list_messages(
queries = [], # optional
search = '<SEARCH>' # optional
)
Create email
Create a new email message.
Request
messageId requiredMessage ID. Choose a custom ID or generate a random ID with
ID.unique()
. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.subject requiredEmail Subject.
content requiredEmail Content.
topics List of Topic IDs.
users List of User IDs.
targets List of Targets IDs.
cc Array of target IDs to be added as CC.
bcc Array of target IDs to be added as BCC.
attachments Array of compound ID strings of bucket IDs and file IDs to be attached to the email. They should be formatted as <BUCKET_ID>:<FILE_ID>.
draft Is message a draft
html Is content of type HTML
scheduledAt Scheduled delivery time for message in ISO 8601 format. DateTime value must be in future.
Response
201
POST /messaging/messages/email
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_email(
message_id = '<MESSAGE_ID>',
subject = '<SUBJECT>',
content = '<CONTENT>',
topics = [], # optional
users = [], # optional
targets = [], # optional
cc = [], # optional
bcc = [], # optional
attachments = [], # optional
draft = False, # optional
html = False, # optional
scheduled_at = '' # optional
)
Update email
Update an email message by its unique ID.
Request
messageId requiredMessage ID.
topics List of Topic IDs.
users List of User IDs.
targets List of Targets IDs.
subject Email Subject.
content Email Content.
draft Is message a draft
html Is content of type HTML
cc Array of target IDs to be added as CC.
bcc Array of target IDs to be added as BCC.
scheduledAt Scheduled delivery time for message in ISO 8601 format. DateTime value must be in future.
attachments Array of compound ID strings of bucket IDs and file IDs to be attached to the email. They should be formatted as <BUCKET_ID>:<FILE_ID>.
Response
200
PATCH /messaging/messages/email/{messageId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_email(
message_id = '<MESSAGE_ID>',
topics = [], # optional
users = [], # optional
targets = [], # optional
subject = '<SUBJECT>', # optional
content = '<CONTENT>', # optional
draft = False, # optional
html = False, # optional
cc = [], # optional
bcc = [], # optional
scheduled_at = '', # optional
attachments = [] # optional
)
Create push notification
Create a new push notification.
Request
messageId requiredMessage ID. Choose a custom ID or generate a random ID with
ID.unique()
. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.title requiredTitle for push notification.
body requiredBody for push notification.
topics List of Topic IDs.
users List of User IDs.
targets List of Targets IDs.
data Additional Data for push notification.
action Action for push notification.
image Image for push notification. Must be a compound bucket ID to file ID of a jpeg, png, or bmp image in Appwrite Storage. It should be formatted as <BUCKET_ID>:<FILE_ID>.
icon Icon for push notification. Available only for Android and Web Platform.
sound Sound for push notification. Available only for Android and IOS Platform.
color Color for push notification. Available only for Android Platform.
tag Tag for push notification. Available only for Android Platform.
badge Badge for push notification. Available only for IOS Platform.
draft Is message a draft
scheduledAt Scheduled delivery time for message in ISO 8601 format. DateTime value must be in future.
Response
201
POST /messaging/messages/push
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_push(
message_id = '<MESSAGE_ID>',
title = '<TITLE>',
body = '<BODY>',
topics = [], # optional
users = [], # optional
targets = [], # optional
data = {}, # optional
action = '<ACTION>', # optional
image = '[ID1:ID2]', # optional
icon = '<ICON>', # optional
sound = '<SOUND>', # optional
color = '<COLOR>', # optional
tag = '<TAG>', # optional
badge = '<BADGE>', # optional
draft = False, # optional
scheduled_at = '' # optional
)
Update push notification
Update a push notification by its unique ID.
Request
messageId requiredMessage ID.
topics List of Topic IDs.
users List of User IDs.
targets List of Targets IDs.
title Title for push notification.
body Body for push notification.
data Additional Data for push notification.
action Action for push notification.
image Image for push notification. Must be a compound bucket ID to file ID of a jpeg, png, or bmp image in Appwrite Storage. It should be formatted as <BUCKET_ID>:<FILE_ID>.
icon Icon for push notification. Available only for Android and Web platforms.
sound Sound for push notification. Available only for Android and iOS platforms.
color Color for push notification. Available only for Android platforms.
tag Tag for push notification. Available only for Android platforms.
badge Badge for push notification. Available only for iOS platforms.
draft Is message a draft
scheduledAt Scheduled delivery time for message in ISO 8601 format. DateTime value must be in future.
Response
200
PATCH /messaging/messages/push/{messageId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_push(
message_id = '<MESSAGE_ID>',
topics = [], # optional
users = [], # optional
targets = [], # optional
title = '<TITLE>', # optional
body = '<BODY>', # optional
data = {}, # optional
action = '<ACTION>', # optional
image = '[ID1:ID2]', # optional
icon = '<ICON>', # optional
sound = '<SOUND>', # optional
color = '<COLOR>', # optional
tag = '<TAG>', # optional
badge = None, # optional
draft = False, # optional
scheduled_at = '' # optional
)
Create SMS
Create a new SMS message.
Request
messageId requiredMessage ID. Choose a custom ID or generate a random ID with
ID.unique()
. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.content requiredSMS Content.
topics List of Topic IDs.
users List of User IDs.
targets List of Targets IDs.
draft Is message a draft
scheduledAt Scheduled delivery time for message in ISO 8601 format. DateTime value must be in future.
Response
201
POST /messaging/messages/sms
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_sms(
message_id = '<MESSAGE_ID>',
content = '<CONTENT>',
topics = [], # optional
users = [], # optional
targets = [], # optional
draft = False, # optional
scheduled_at = '' # optional
)
Update SMS
Update an email message by its unique ID.
PATCH /messaging/messages/sms/{messageId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_sms(
message_id = '<MESSAGE_ID>',
topics = [], # optional
users = [], # optional
targets = [], # optional
content = '<CONTENT>', # optional
draft = False, # optional
scheduled_at = '' # optional
)
GET /messaging/messages/{messageId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.get_message(
message_id = '<MESSAGE_ID>'
)
Delete message
Delete a message. If the message is not a draft or scheduled, but has been sent, this will not recall the message.
Request
messageId requiredMessage ID.
Response
204
DELETE /messaging/messages/{messageId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.delete(
message_id = '<MESSAGE_ID>'
)
List message logs
Get the message activity logs listed by its unique ID.
Request
messageId requiredMessage ID.
queries Array of query strings generated using the Query class provided by the SDK. Learn more about queries. Only supported methods are limit and offset
Response
200
GET /messaging/messages/{messageId}/logs
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.list_message_logs(
message_id = '<MESSAGE_ID>',
queries = [] # optional
)
List message targets
Get a list of the targets associated with a message.
Request
messageId requiredMessage ID.
queries Array of query strings generated using the Query class provided by the SDK. Learn more about queries. Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: userId, providerId, identifier, providerType
Response
200
GET /messaging/messages/{messageId}/targets
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.list_targets(
message_id = '<MESSAGE_ID>',
queries = [] # optional
)
List providers
Get a list of all providers from the current Appwrite project.
Request
queries Array of query strings generated using the Query class provided by the SDK. Learn more about queries. Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, provider, type, enabled
search Search term to filter your list results. Max length: 256 chars.
Response
200
GET /messaging/providers
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.list_providers(
queries = [], # optional
search = '<SEARCH>' # optional
)
Create APNS provider
Create a new Apple Push Notification service provider.
Request
providerId requiredProvider ID. Choose a custom ID or generate a random ID with
ID.unique()
. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.name requiredProvider name.
authKey APNS authentication key.
authKeyId APNS authentication key ID.
teamId APNS team ID.
bundleId APNS bundle ID.
sandbox Use APNS sandbox environment.
enabled Set as enabled.
Response
201
POST /messaging/providers/apns
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_apns_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>',
auth_key = '<AUTH_KEY>', # optional
auth_key_id = '<AUTH_KEY_ID>', # optional
team_id = '<TEAM_ID>', # optional
bundle_id = '<BUNDLE_ID>', # optional
sandbox = False, # optional
enabled = False # optional
)
Update APNS provider
Update a Apple Push Notification service provider by its unique ID.
Request
providerId requiredProvider ID.
name Provider name.
enabled Set as enabled.
authKey APNS authentication key.
authKeyId APNS authentication key ID.
teamId APNS team ID.
bundleId APNS bundle ID.
sandbox Use APNS sandbox environment.
Response
200
PATCH /messaging/providers/apns/{providerId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_apns_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>', # optional
enabled = False, # optional
auth_key = '<AUTH_KEY>', # optional
auth_key_id = '<AUTH_KEY_ID>', # optional
team_id = '<TEAM_ID>', # optional
bundle_id = '<BUNDLE_ID>', # optional
sandbox = False # optional
)
Create FCM provider
Create a new Firebase Cloud Messaging provider.
Request
providerId requiredProvider ID. Choose a custom ID or generate a random ID with
ID.unique()
. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.name requiredProvider name.
serviceAccountJSON FCM service account JSON.
enabled Set as enabled.
Response
201
POST /messaging/providers/fcm
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_fcm_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>',
service_account_json = {}, # optional
enabled = False # optional
)
Update FCM provider
Update a Firebase Cloud Messaging provider by its unique ID.
Request
providerId requiredProvider ID.
name Provider name.
enabled Set as enabled.
serviceAccountJSON FCM service account JSON.
Response
200
PATCH /messaging/providers/fcm/{providerId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_fcm_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>', # optional
enabled = False, # optional
service_account_json = {} # optional
)
Create Mailgun provider
Create a new Mailgun provider.
Request
providerId requiredProvider ID. Choose a custom ID or generate a random ID with
ID.unique()
. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.name requiredProvider name.
apiKey Mailgun API Key.
domain Mailgun Domain.
isEuRegion Set as EU region.
fromName Sender Name.
fromEmail Sender email address.
replyToName Name set in the reply to field for the mail. Default value is sender name. Reply to name must have reply to email as well.
replyToEmail Email set in the reply to field for the mail. Default value is sender email. Reply to email must have reply to name as well.
enabled Set as enabled.
Response
201
POST /messaging/providers/mailgun
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_mailgun_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>',
api_key = '<API_KEY>', # optional
domain = '<DOMAIN>', # optional
is_eu_region = False, # optional
from_name = '<FROM_NAME>', # optional
from_email = 'email@example.com', # optional
reply_to_name = '<REPLY_TO_NAME>', # optional
reply_to_email = 'email@example.com', # optional
enabled = False # optional
)
Update Mailgun provider
Update a Mailgun provider by its unique ID.
Request
providerId requiredProvider ID.
name Provider name.
apiKey Mailgun API Key.
domain Mailgun Domain.
isEuRegion Set as EU region.
enabled Set as enabled.
fromName Sender Name.
fromEmail Sender email address.
replyToName Name set in the reply to field for the mail. Default value is sender name.
replyToEmail Email set in the reply to field for the mail. Default value is sender email.
Response
200
PATCH /messaging/providers/mailgun/{providerId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_mailgun_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>', # optional
api_key = '<API_KEY>', # optional
domain = '<DOMAIN>', # optional
is_eu_region = False, # optional
enabled = False, # optional
from_name = '<FROM_NAME>', # optional
from_email = 'email@example.com', # optional
reply_to_name = '<REPLY_TO_NAME>', # optional
reply_to_email = '<REPLY_TO_EMAIL>' # optional
)
Create Msg91 provider
Create a new MSG91 provider.
Request
providerId requiredProvider ID. Choose a custom ID or generate a random ID with
ID.unique()
. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.name requiredProvider name.
templateId Msg91 template ID
senderId Msg91 sender ID.
authKey Msg91 auth key.
enabled Set as enabled.
Response
201
POST /messaging/providers/msg91
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_msg91_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>',
template_id = '<TEMPLATE_ID>', # optional
sender_id = '<SENDER_ID>', # optional
auth_key = '<AUTH_KEY>', # optional
enabled = False # optional
)
Update Msg91 provider
Update a MSG91 provider by its unique ID.
Request
providerId requiredProvider ID.
name Provider name.
enabled Set as enabled.
templateId Msg91 template ID.
senderId Msg91 sender ID.
authKey Msg91 auth key.
Response
200
PATCH /messaging/providers/msg91/{providerId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_msg91_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>', # optional
enabled = False, # optional
template_id = '<TEMPLATE_ID>', # optional
sender_id = '<SENDER_ID>', # optional
auth_key = '<AUTH_KEY>' # optional
)
Create Sendgrid provider
Create a new Sendgrid provider.
Request
providerId requiredProvider ID. Choose a custom ID or generate a random ID with
ID.unique()
. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.name requiredProvider name.
apiKey Sendgrid API key.
fromName Sender Name.
fromEmail Sender email address.
replyToName Name set in the reply to field for the mail. Default value is sender name.
replyToEmail Email set in the reply to field for the mail. Default value is sender email.
enabled Set as enabled.
Response
201
POST /messaging/providers/sendgrid
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_sendgrid_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>',
api_key = '<API_KEY>', # optional
from_name = '<FROM_NAME>', # optional
from_email = 'email@example.com', # optional
reply_to_name = '<REPLY_TO_NAME>', # optional
reply_to_email = 'email@example.com', # optional
enabled = False # optional
)
Update Sendgrid provider
Update a Sendgrid provider by its unique ID.
Request
providerId requiredProvider ID.
name Provider name.
enabled Set as enabled.
apiKey Sendgrid API key.
fromName Sender Name.
fromEmail Sender email address.
replyToName Name set in the Reply To field for the mail. Default value is Sender Name.
replyToEmail Email set in the Reply To field for the mail. Default value is Sender Email.
Response
200
PATCH /messaging/providers/sendgrid/{providerId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_sendgrid_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>', # optional
enabled = False, # optional
api_key = '<API_KEY>', # optional
from_name = '<FROM_NAME>', # optional
from_email = 'email@example.com', # optional
reply_to_name = '<REPLY_TO_NAME>', # optional
reply_to_email = '<REPLY_TO_EMAIL>' # optional
)
Create SMTP provider
Create a new SMTP provider.
Request
providerId requiredProvider ID. Choose a custom ID or generate a random ID with
ID.unique()
. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.name requiredProvider name.
host requiredSMTP hosts. Either a single hostname or multiple semicolon-delimited hostnames. You can also specify a different port for each host such as
smtp1.example.com:25;smtp2.example.com
. You can also specify encryption type, for example:tls://smtp1.example.com:587;ssl://smtp2.example.com:465"
. Hosts will be tried in order.port The default SMTP server port.
username Authentication username.
password Authentication password.
encryption Encryption type. Can be omitted, 'ssl', or 'tls'
autoTLS Enable SMTP AutoTLS feature.
mailer The value to use for the X-Mailer header.
fromName Sender Name.
fromEmail Sender email address.
replyToName Name set in the reply to field for the mail. Default value is sender name.
replyToEmail Email set in the reply to field for the mail. Default value is sender email.
enabled Set as enabled.
Response
201
POST /messaging/providers/smtp
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_smtp_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>',
host = '<HOST>',
port = 1, # optional
username = '<USERNAME>', # optional
password = '<PASSWORD>', # optional
encryption = SmtpEncryption.NONE, # optional
auto_tls = False, # optional
mailer = '<MAILER>', # optional
from_name = '<FROM_NAME>', # optional
from_email = 'email@example.com', # optional
reply_to_name = '<REPLY_TO_NAME>', # optional
reply_to_email = 'email@example.com', # optional
enabled = False # optional
)
Update SMTP provider
Update a SMTP provider by its unique ID.
Request
providerId requiredProvider ID.
name Provider name.
host SMTP hosts. Either a single hostname or multiple semicolon-delimited hostnames. You can also specify a different port for each host such as
smtp1.example.com:25;smtp2.example.com
. You can also specify encryption type, for example:tls://smtp1.example.com:587;ssl://smtp2.example.com:465"
. Hosts will be tried in order.port SMTP port.
username Authentication username.
password Authentication password.
encryption Encryption type. Can be 'ssl' or 'tls'
autoTLS Enable SMTP AutoTLS feature.
mailer The value to use for the X-Mailer header.
fromName Sender Name.
fromEmail Sender email address.
replyToName Name set in the Reply To field for the mail. Default value is Sender Name.
replyToEmail Email set in the Reply To field for the mail. Default value is Sender Email.
enabled Set as enabled.
Response
200
PATCH /messaging/providers/smtp/{providerId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_smtp_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>', # optional
host = '<HOST>', # optional
port = 1, # optional
username = '<USERNAME>', # optional
password = '<PASSWORD>', # optional
encryption = SmtpEncryption.NONE, # optional
auto_tls = False, # optional
mailer = '<MAILER>', # optional
from_name = '<FROM_NAME>', # optional
from_email = 'email@example.com', # optional
reply_to_name = '<REPLY_TO_NAME>', # optional
reply_to_email = '<REPLY_TO_EMAIL>', # optional
enabled = False # optional
)
Create Telesign provider
Create a new Telesign provider.
Request
providerId requiredProvider ID. Choose a custom ID or generate a random ID with
ID.unique()
. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.name requiredProvider name.
from Sender Phone number. Format this number with a leading '+' and a country code, e.g., +16175551212.
customerId Telesign customer ID.
apiKey Telesign API key.
enabled Set as enabled.
Response
201
POST /messaging/providers/telesign
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_telesign_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>',
from = '+12065550100', # optional
customer_id = '<CUSTOMER_ID>', # optional
api_key = '<API_KEY>', # optional
enabled = False # optional
)
Update Telesign provider
Update a Telesign provider by its unique ID.
Request
providerId requiredProvider ID.
name Provider name.
enabled Set as enabled.
customerId Telesign customer ID.
apiKey Telesign API key.
from Sender number.
Response
200
PATCH /messaging/providers/telesign/{providerId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_telesign_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>', # optional
enabled = False, # optional
customer_id = '<CUSTOMER_ID>', # optional
api_key = '<API_KEY>', # optional
from = '<FROM>' # optional
)
Create Textmagic provider
Create a new Textmagic provider.
Request
providerId requiredProvider ID. Choose a custom ID or generate a random ID with
ID.unique()
. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.name requiredProvider name.
from Sender Phone number. Format this number with a leading '+' and a country code, e.g., +16175551212.
username Textmagic username.
apiKey Textmagic apiKey.
enabled Set as enabled.
Response
201
POST /messaging/providers/textmagic
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_textmagic_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>',
from = '+12065550100', # optional
username = '<USERNAME>', # optional
api_key = '<API_KEY>', # optional
enabled = False # optional
)
Update Textmagic provider
Update a Textmagic provider by its unique ID.
Request
providerId requiredProvider ID.
name Provider name.
enabled Set as enabled.
username Textmagic username.
apiKey Textmagic apiKey.
from Sender number.
Response
200
PATCH /messaging/providers/textmagic/{providerId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_textmagic_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>', # optional
enabled = False, # optional
username = '<USERNAME>', # optional
api_key = '<API_KEY>', # optional
from = '<FROM>' # optional
)
Create Twilio provider
Create a new Twilio provider.
Request
providerId requiredProvider ID. Choose a custom ID or generate a random ID with
ID.unique()
. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.name requiredProvider name.
from Sender Phone number. Format this number with a leading '+' and a country code, e.g., +16175551212.
accountSid Twilio account secret ID.
authToken Twilio authentication token.
enabled Set as enabled.
Response
201
POST /messaging/providers/twilio
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_twilio_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>',
from = '+12065550100', # optional
account_sid = '<ACCOUNT_SID>', # optional
auth_token = '<AUTH_TOKEN>', # optional
enabled = False # optional
)
Update Twilio provider
Update a Twilio provider by its unique ID.
Request
providerId requiredProvider ID.
name Provider name.
enabled Set as enabled.
accountSid Twilio account secret ID.
authToken Twilio authentication token.
from Sender number.
Response
200
PATCH /messaging/providers/twilio/{providerId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_twilio_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>', # optional
enabled = False, # optional
account_sid = '<ACCOUNT_SID>', # optional
auth_token = '<AUTH_TOKEN>', # optional
from = '<FROM>' # optional
)
Create Vonage provider
Create a new Vonage provider.
Request
providerId requiredProvider ID. Choose a custom ID or generate a random ID with
ID.unique()
. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.name requiredProvider name.
from Sender Phone number. Format this number with a leading '+' and a country code, e.g., +16175551212.
apiKey Vonage API key.
apiSecret Vonage API secret.
enabled Set as enabled.
Response
201
POST /messaging/providers/vonage
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_vonage_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>',
from = '+12065550100', # optional
api_key = '<API_KEY>', # optional
api_secret = '<API_SECRET>', # optional
enabled = False # optional
)
Update Vonage provider
Update a Vonage provider by its unique ID.
Request
providerId requiredProvider ID.
name Provider name.
enabled Set as enabled.
apiKey Vonage API key.
apiSecret Vonage API secret.
from Sender number.
Response
200
PATCH /messaging/providers/vonage/{providerId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_vonage_provider(
provider_id = '<PROVIDER_ID>',
name = '<NAME>', # optional
enabled = False, # optional
api_key = '<API_KEY>', # optional
api_secret = '<API_SECRET>', # optional
from = '<FROM>' # optional
)
GET /messaging/providers/{providerId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.get_provider(
provider_id = '<PROVIDER_ID>'
)
Delete provider
Delete a provider by its unique ID.
Request
providerId requiredProvider ID.
Response
204
DELETE /messaging/providers/{providerId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.delete_provider(
provider_id = '<PROVIDER_ID>'
)
List provider logs
Get the provider activity logs listed by its unique ID.
Request
providerId requiredProvider ID.
queries Array of query strings generated using the Query class provided by the SDK. Learn more about queries. Only supported methods are limit and offset
Response
200
GET /messaging/providers/{providerId}/logs
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.list_provider_logs(
provider_id = '<PROVIDER_ID>',
queries = [] # optional
)
List subscriber logs
Get the subscriber activity logs listed by its unique ID.
Request
subscriberId requiredSubscriber ID.
queries Array of query strings generated using the Query class provided by the SDK. Learn more about queries. Only supported methods are limit and offset
Response
200
GET /messaging/subscribers/{subscriberId}/logs
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.list_subscriber_logs(
subscriber_id = '<SUBSCRIBER_ID>',
queries = [] # optional
)
List topics
Get a list of all topics from the current Appwrite project.
Request
queries Array of query strings generated using the Query class provided by the SDK. Learn more about queries. Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, description, emailTotal, smsTotal, pushTotal
search Search term to filter your list results. Max length: 256 chars.
Response
200
GET /messaging/topics
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.list_topics(
queries = [], # optional
search = '<SEARCH>' # optional
)
Create topic
Create a new topic.
Request
topicId requiredTopic ID. Choose a custom Topic ID or a new Topic ID.
name requiredTopic Name.
subscribe An array of role strings with subscribe permission. By default all users are granted with any subscribe permission. learn more about roles. Maximum of 100 roles are allowed, each 64 characters long.
Response
201
POST /messaging/topics
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.create_topic(
topic_id = '<TOPIC_ID>',
name = '<NAME>',
subscribe = ["any"] # optional
)
GET /messaging/topics/{topicId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.get_topic(
topic_id = '<TOPIC_ID>'
)
Update topic
Update a topic by its unique ID.
Request
topicId requiredTopic ID.
name Topic Name.
subscribe An array of role strings with subscribe permission. By default all users are granted with any subscribe permission. learn more about roles. Maximum of 100 roles are allowed, each 64 characters long.
Response
200
PATCH /messaging/topics/{topicId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.update_topic(
topic_id = '<TOPIC_ID>',
name = '<NAME>', # optional
subscribe = ["any"] # optional
)
DELETE /messaging/topics/{topicId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.delete_topic(
topic_id = '<TOPIC_ID>'
)
List topic logs
Get the topic activity logs listed by its unique ID.
Request
topicId requiredTopic ID.
queries Array of query strings generated using the Query class provided by the SDK. Learn more about queries. Only supported methods are limit and offset
Response
200
GET /messaging/topics/{topicId}/logs
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.list_topic_logs(
topic_id = '<TOPIC_ID>',
queries = [] # optional
)
List subscribers
Get a list of all subscribers from the current Appwrite project.
Request
topicId requiredTopic ID. The topic ID subscribed to.
queries Array of query strings generated using the Query class provided by the SDK. Learn more about queries. Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, provider, type, enabled
search Search term to filter your list results. Max length: 256 chars.
Response
200
GET /messaging/topics/{topicId}/subscribers
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.list_subscribers(
topic_id = '<TOPIC_ID>',
queries = [], # optional
search = '<SEARCH>' # optional
)
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
POST /messaging/topics/{topicId}/subscribers
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_jwt('<YOUR_JWT>') # Your secret JSON Web Token
messaging = Messaging(client)
result = messaging.create_subscriber(
topic_id = '<TOPIC_ID>',
subscriber_id = '<SUBSCRIBER_ID>',
target_id = '<TARGET_ID>'
)
Get subscriber
Get a subscriber by its unique ID.
Request
topicId requiredTopic ID. The topic ID subscribed to.
subscriberId requiredSubscriber ID.
Response
200
GET /messaging/topics/{topicId}/subscribers/{subscriberId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key
messaging = Messaging(client)
result = messaging.get_subscriber(
topic_id = '<TOPIC_ID>',
subscriber_id = '<SUBSCRIBER_ID>'
)
Delete subscriber
Delete a subscriber by its unique ID.
Request
topicId requiredTopic ID. The topic ID subscribed to.
subscriberId requiredSubscriber ID.
Response
204
DELETE /messaging/topics/{topicId}/subscribers/{subscriberId}
from appwrite.client import Client
client = Client()
client.set_endpoint('https://cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_jwt('<YOUR_JWT>') # Your secret JSON Web Token
messaging = Messaging(client)
result = messaging.delete_subscriber(
topic_id = '<TOPIC_ID>',
subscriber_id = '<SUBSCRIBER_ID>'
)