Update docs and examples

docs/resources/action.md

@@ -11,6 +11,9 @@ Actions are secure, tenant-specific, versioned functions written in Node.js that
 ## Example Usage
 
 ```terraform
+// Note : we are unable to delete an action bound to a trigger
+// So, first try to import the auth0_trigger_action with the corresponding trigger id
+// and delete the imported auth0_trigger_action's resource to delete the action.
 resource "auth0_action" "my_action" {
   name    = format("Test Action %s", timestamp())
   runtime = "node18"

docs/resources/email_provider.md

@@ -77,9 +77,35 @@ resource "auth0_email_provider" "ms365_email_provider" {
 
 # This is an example on how to set up the email provider with a custom action.
 # Make sure a corresponding action exists with custom-email-provider as supported triggers
+resource "auth0_action" "send_custom_email" {
+  name    = "Custom Email Provider"
+  runtime = "node18"
+  deploy  = true
+  code    = <<-EOT
+  /**
+   * Handler to be executed while sending an email notification.
+   *
+   * @param {Event} event - Details about the user and the context in which they are logging in.
+   * @param {CustomEmailProviderAPI} api - Methods and utilities to help change the behavior of sending a email notification.
+   */
+   exports.onExecuteCustomEmailProvider = async (event, api) => {
+    // Code goes here
+    console.log(event);
+    return;
+   };
+  EOT
+
+
+  supported_triggers {
+    id      = "custom-email-provider"
+    version = "v1"
+  }
+}
+
 resource "auth0_email_provider" "custom_email_provider" {
-  name                 = "custom"
-  enabled              = true
+  depends_on           = [auth0_action.send_custom_email] # Ensure the action is created first with `custom-email-provider` as the supported_triggers
+  name                 = "custom"                         # Indicates a custom implementation
+  enabled              = true                             # Disable the default email provider
   default_from_address = "[email protected]"
   credentials {}
 }

docs/resources/trigger_action.md

@@ -45,7 +45,7 @@ resource "auth0_trigger_action" "post_login_alert_action" {
 ### Required
 
 - `action_id` (String) The ID of the action to bind to the trigger.
-- `trigger` (String) The ID of the trigger to bind with. Available options: `post-login`, `credentials-exchange`, `pre-user-registration`, `post-user-registration`, `post-change-password`, `send-phone-message`, `password-reset-post-challenge`.
+- `trigger` (String) The ID of the trigger to bind with. Available options: `post-login`, `credentials-exchange`, `pre-user-registration`, `post-user-registration`, `post-change-password`, `send-phone-message`, `password-reset-post-challenge`, `custom-email-provider`.
 
 ### Optional
 

examples/resources/auth0_action/resource.tf

@@ -1,3 +1,6 @@
+// Note : we are unable to delete an action bound to a trigger
+// So, first try to import the auth0_trigger_action with the corresponding trigger id
+// and delete the imported auth0_trigger_action's resource to delete the action.
 resource "auth0_action" "my_action" {
   name    = format("Test Action %s", timestamp())
   runtime = "node18"

examples/resources/auth0_email_provider/resource.tf

@@ -64,9 +64,35 @@ resource "auth0_email_provider" "ms365_email_provider" {
 
 # This is an example on how to set up the email provider with a custom action.
 # Make sure a corresponding action exists with custom-email-provider as supported triggers
+resource "auth0_action" "send_custom_email" {
+  name    = "Custom Email Provider"
+  runtime = "node18"
+  deploy  = true
+  code    = <<-EOT
+  /**
+   * Handler to be executed while sending an email notification.
+   *
+   * @param {Event} event - Details about the user and the context in which they are logging in.
+   * @param {CustomEmailProviderAPI} api - Methods and utilities to help change the behavior of sending a email notification.
+   */
+   exports.onExecuteCustomEmailProvider = async (event, api) => {
+    // Code goes here
+    console.log(event);
+    return;
+   };
+  EOT
+
+
+  supported_triggers {
+    id      = "custom-email-provider"
+    version = "v1"
+  }
+}
+
 resource "auth0_email_provider" "custom_email_provider" {
-  name                 = "custom"
-  enabled              = true
+  depends_on           = [auth0_action.send_custom_email] # Ensure the action is created first with `custom-email-provider` as the supported_triggers
+  name                 = "custom"                         # Indicates a custom implementation
+  enabled              = true                             # Disable the default email provider
   default_from_address = "[email protected]"
   credentials {}
 }

internal/auth0/action/resource_trigger_action.go

@@ -38,8 +38,9 @@ func NewTriggerActionResource() *schema.Resource {
 					"post-change-password",
 					"send-phone-message",
 					"password-reset-post-challenge",
+					"custom-email-provider",
 				}, false),
-				Description: "The ID of the trigger to bind with. Available options: `post-login`, `credentials-exchange`, `pre-user-registration`, `post-user-registration`, `post-change-password`, `send-phone-message`, `password-reset-post-challenge`.",
+				Description: "The ID of the trigger to bind with. Available options: `post-login`, `credentials-exchange`, `pre-user-registration`, `post-user-registration`, `post-change-password`, `send-phone-message`, `password-reset-post-challenge`, `custom-email-provider`.",
 			},
 			"action_id": {
 				Type:        schema.TypeString,