Import the Postman collection

Import Samva's official collection to test and explore the email API from Postman. The collection is derived from the same public email API contract as the API reference and SDK.

Import the collection

Authenticate the collection

The collection already sends x-api-key from its apiKey variable. Set the variable once so every request inherits it.

1. Click the collection name in the sidebar.
2. Go to the Variables tab.
3. Add a variable named apiKey and set its value to your API key.
4. Click Save.

Set up environments

Use a Postman environment so requests reference variables instead of hardcoded values.

// Production
{
  "baseUrl": "https://api.samva.dev",
  "apiKey": "samva_sk_live_your_api_key",
  "recipientEmail": "ada@example.com"
}

Send a test request

Start with the read-only GET /v1/organizations/current request. A 200 response confirms the base URL and API key without changing data.

When you are ready to send a real email:

1. Open the request for POST /v1/messages.

2. Set the body to an email send payload:

   {
     "to": [{ "email": "ada@example.com" }],
     "channel": "email",
     "email": {
       "subject": "Welcome to Samva",
       "html": "<h1>Welcome!</h1>"
     }
   }

3. Confirm the recipient and sender setup. This request creates a message and can send a real email.

4. Click Send and check the response.

Next steps