Update configure-environment-variables.mdx

fulleni · web-flow · commit 99922b54c347 · 2025-07-28T07:50:45.000+01:00
Signed-off-by: fulleni &lt;fulleni@hotmail.com&gt;
diff --git a/src/content/docs/api-server/guides/configure-environment-variables.mdx b/src/content/docs/api-server/guides/configure-environment-variables.mdx
@@ -45,23 +45,53 @@ A long, random password used to secure your API.
 Your API key for the SendGrid service, which is used to send transactional emails like One-Time Passwords (OTPs).
 
 -   **How to Obtain:**
-    1.  Create a [SendGrid account](https://signup.sendgrid.com/).
-    2.  Navigate to **Settings > API Keys** in your SendGrid dashboard.
-    3.  Create a new API key with "Full Access" or restricted permissions for sending mail.
-    4.  Copy the generated key and paste it here.
+    1.  create a free [SendGrid account](https://signup.sendgrid.com/).
+    2.  create your API key, follow the [official SendGrid guide](https://www.twilio.com/docs/sendgrid/ui/account-and-settings/api-keys#creating-an-api-key).
+    3.  Copy the generated key and paste it here.
 
 #### `DEFAULT_SENDER_EMAIL`
 The email address that will appear as the sender for all transactional emails. This should be an email address you have verified with SendGrid.
 
+<Aside type="caution">
+SendGrid requires you to prove you own this email address to prevent it from rejecting your emails. This is done through a process called "Single Sender Verification".
+</Aside>
+
+**How to Verify:** Follow the [official SendGrid guide](https://www.twilio.com/docs/sendgrid/ui/sending-email/sender-verification). You will need to click a confirmation link sent to that address.
+
+
 #### `OTP_TEMPLATE_ID`
 The ID of the dynamic email template in SendGrid used for sending OTP codes.
 
--   **How to Obtain:**
-    1.  In your SendGrid dashboard, go to **Email API > Dynamic Templates**.
-    2.  Create a new template. The template must include a variable for the code (e.g., `{{otp_code}}`).
-    3.  Copy the Template ID and paste it here.
+-    **Steps to Create the Template:**
 
----
+    1.  Go directly to SendGrid's [**Dynamic Templates page**](https://mc.sendgrid.com/dynamic-templates).
+
+    2.  Click "**Create a Dynamic Template**" and give it a name (e.g., "OTP Template").
+
+    3.  Click your new template, then click "**Add Version**" and choose the "Blank Template" then the  "**Code Editor**".
+
+    4.  Empty all existing HTML code then paste the code below. It includes the required `{{otp_code}}` placeholder.
+
+
+    ```html
+    <!DOCTYPE html>
+    <html>
+    <head>
+      <title>Your One-Time Password</title>
+    </head>
+    <body style="font-family: sans-serif; text-align: center; padding: 40px;">
+      <div style="max-width: 600px; margin: auto; border: 1px solid #ddd; padding: 20px; border-radius: 8px;">
+        <h2 style="color: #333;">Your One-Time Password</h2>
+        <p style="color: #555;">Use the code below to complete your sign-in.</p>
+        <div style="font-size: 36px; font-weight: bold; letter-spacing: 5px; margin: 20px 0; padding: 15px; background-color: #f5f5f5; border-radius: 5px;">
+          {{otp_code}}
+        </div>
+        <p style="color: #888; font-size: 12px;">This code will expire in 10 minutes. If you did not request this, please ignore this email.</p>
+      </div>
+    </body>
+    </html>
+    ```
+5.  **Save the template**. Go back to the main Dynamic Templates page and copy the **Template ID**. You will need this ID for your server configuration.
 
 ### Optional Variables
 
