Quickstart

This guide sends your first transactional email through Notavia.

1. Get an API key. In the dashboard, open Settings → API keys and copy a test secret key (it starts with nsk_test_). Test sends are never billed and never leave Notavia.

2. Send a notification. Replace nsk_test_... with your key and pick your language:

   cURL

   curl https://api.notavia.saas-infrastructure.com/v1/notifications \
     -H "Authorization: Bearer nsk_test_..." \
     -H "Content-Type: application/json" \
     -d '{
       "channel": "email",
       "recipient": { "address": "alice@example.com", "name": "Alice" },
       "subject": "Welcome",
       "html_body": "<h1>Hello!</h1>"
     }'

   .NET

   using NotifyService.Sdk;
   
   var client = new NotifyClient(new NotifyClientOptions
   {
       BaseUrl = "https://api.notavia.saas-infrastructure.com",
       ApiKey = "nsk_test_...",
   });
   
   var notification = await client.Notifications.SendAsync(new SendNotificationRequest
   {
       Channel = "email",
       Recipient = new Recipient { Address = "alice@example.com", Name = "Alice" },
       Subject = "Welcome",
       HtmlBody = "<h1>Hello!</h1>",
   });
   
   Console.WriteLine(notification.Id);

   TypeScript

   import { NotifyClient } from 'notavia-sdk';
   
   const client = new NotifyClient({
     baseUrl: 'https://api.notavia.saas-infrastructure.com',
     apiKey: 'nsk_test_...',
   });
   
   const notification = await client.notifications.send({
     channel: 'email',
     recipient: { address: 'alice@example.com', name: 'Alice' },
     subject: 'Welcome',
     htmlBody: '<h1>Hello!</h1>',
   });
   
   console.log(notification.id);

3. Check the delivery log. Open Notifications in the dashboard — your test send appears with its status. (Test sends are recorded but not delivered to a real inbox.)

4. Go live. Verify your sender domain (Settings → Domains), switch to a nsk_live_ key, and the same call sends real email.

Next steps

• Authentication & environments — key types and scopes.
• Sending email — managed vs. bring-your-own provider.
• SDKs — install the client for your language.