Quickstart

1. Create your account and workspace

   Sign up at app.notils.com, verify your email, and name your workspace. A workspace holds your team's templates, API keys and send history.

2. Design a template

   Open Templates → New template, give it a name and a key such as welcome. The key is what your code sends with, and it can't change later.

   Write on the page. Type / on an empty line for a button, image or divider, and use {{name}} anywhere you want a value filled in. Every change saves itself.

3. Check it, then publish

   Switch to Preview to see the exact email at desktop and mobile width, try sample values, and send yourself a test. When it's right, open Publish → Go live.

4. Create an API key

   In Developers, create a key — one per environment is a good habit. It's shown once; store it in your server's secrets as NOTILS_API_KEY.

5. Send it

   Call the sending endpoint from your backend:

   cURL

   curl https://notify-api.notils.com/v1/emails/send \
     -H "Authorization: Bearer $NOTILS_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "template_key": "welcome",
       "to": "ram@example.com",
       "variables": { "name": "Ram" }
     }'

   Node.js

   const response = await fetch("https://notify-api.notils.com/v1/emails/send", {
     method: "POST",
     headers: {
       Authorization: `Bearer ${process.env.NOTILS_API_KEY}`,
       "Content-Type": "application/json",
     },
     body: JSON.stringify({
       template_key: "welcome",
       to: "ram@example.com",
       variables: { name: "Ram" },
     }),
   });
   if (!response.ok) {
     const { error } = await response.json();
     throw new Error(`Notify ${response.status}: ${error.message}`);
   }

   A 202 means the email was handed to delivery. It appears in Activity straight away, with the template version that was sent.

Next, the reference covers every response your code should handle.