Is the message.deleted webhook trigger supported? How do I set it up?

Overview

Yes. The message.deleted webhook trigger is supported in Nylas API v3 and allows you to receive notifications when email messages are permanently deleted from connected accounts.

This feature is currently in beta and must be configured via the API (it is not available in the Dashboard UI).

Availability

Implementation

Prerequisites

• ✅ Valid Nylas API key
• ✅ Existing webhook configuration
• ✅ Webhook ID from your current setup

Step 1: Update Webhook Configuration

Add message.deleted to your webhook trigger types using the Update Webhook endpoint:

curl --request PUT \
 --url 'https://api.us.nylas.com/v3/webhooks/WEBHOOK_ID' \
 --header 'Content-Type: application/json' \
 --header 'Authorization: Bearer NYLAS_API_KEY' \
 --data '{
   "trigger_types": [
     "message.created",
     "message.updated",
     "message.deleted"
   ]
 }'

Important: This request replaces your entire trigger list. Make sure to include all triggers you need, not just message.deleted.
 

Step 2: Verify Configuration

Confirm the webhook includes message.deleted in trigger_types:

curl --request GET \
 --url 'https://api.us.nylas.com/v3/webhooks/WEBHOOK_ID' \
 --header 'Authorization: Bearer NYLAS_API_KEY'

What should I know?

• The event fires only after permanent deletion (not archive or move to Trash) 
• Payload is minimal (message ID and grant ID only) 
• Deleted messages cannot be retrieved 

Supported providers: 

• Gmail, Microsoft Graph, EWS 
• Limited support: IMAP, Yahoo, iCloud

Support

Because this feature is in beta, contact Nylas Support for missing events or unexpected behavior.