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), Customers (Auth), organizations (B2B).
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. Not sure which ones you need? See Choose your setup.
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, Organizations, 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.