Getting Started
Create a Mailmus account and a project, and get your API keys.
1. Create an account
Sign up at mailmus.app. A Mailmus account is created, with a first project by default. A project holds your keys and the data of the products you use in it: contacts and campaigns (Mail) and Customers (Auth).
Open the project and choose its products under Project → Products. Its menu then shows only what you use, and you can add another product at any time.
You can create more projects later (one per environment, for instance: development and production) from the dashboard.
2. Get your API keys
Every project has two kinds of key, under Project → API Keys:
| Key | What it is for | Where to use it |
|---|---|---|
| Secret key | Every server-side operation: Mail (contacts, campaigns, transactional sending, and so on) and Auth admin (managing Customers, and so on) | Backend only — server SDK mailmus |
| Publishable key | Auth operations running in your Customers' browser (sign-up, sign-in, OAuth, and so on) | Frontend — browser SDK @mailmus/auth |
Never expose the secret key on the client
The secret key gives full access to your Mail and Auth data. It must never leave your backend — not in frontend code, not in a public repository. The publishable key, on the other hand, is made to be exposed in the browser.
3. Next step
- Send your first email with the secret key and the server SDK.
- Add authentication with the publishable key in the browser and the secret key on your server.