Email and mailing services
Email is two separate things in Brixit, configured independently: delivery, which sends mail out, and inbox sync, which reads replies back in.
Delivery is not optional. Invitations, password resets and enquiry alerts all go through it, so this is worth setting up before anything else.
Outbound delivery
Settings → Integration keys → Email → Email delivery.
| Field | Where to find it |
|---|---|
| Domain | Mailgun dashboard, Sending → Domains |
| Secret | The sending API key for that domain |
| Endpoint | api.mailgun.net or api.eu.mailgun.net |
| From Address | The address mail should appear to come from |
| From Name | The name beside it, usually your brokerage |
The Endpoint matters: a domain created in Mailgun’s EU region will reject calls to the US endpoint with an authentication error that reads as a bad API key.
Your sending domain must have its SPF and DKIM records published and verified in Mailgun before mail will be accepted. Mailgun’s dashboard shows exactly which DNS records to add.
Send a test message from Settings → Notifications once saved.
Inbox sync — Gmail
Settings → Integration keys → Email → Gmail Inbox.
| Field | Where to find it |
|---|---|
| Client ID | Google Cloud Console, APIs & Services → Credentials |
| Client Secret | Same credential |
| Pub/Sub Topic | The topic you create for push notifications |
Enable the Gmail API in your Google Cloud project, and add the redirect URI from the Brixit card to the OAuth client.
The Pub/Sub Topic is how Gmail tells Brixit that new mail has arrived instead of being polled. Create a topic in Google Cloud Pub/Sub, grant gmail-api-push@system.gserviceaccount.com the Pub/Sub Publisher role on it, and paste the full topic name (projects/your-project/topics/your-topic).
Inbox sync — Outlook
Settings → Integration keys → Email → Outlook Inbox.
| Field | Where to find it |
|---|---|
| Client ID | Azure portal, App registrations → your app |
| Client Secret | Certificates & secrets, shown once at creation |
| Tenant | Your directory ID, or common for any account |
Grant the app Mail.Read and offline_access under API permissions, and add the redirect URI from the Brixit card.
Azure client secrets expire — 24 months at most, and often less. Note the expiry somewhere you will see it, because the failure mode is inbox sync quietly stopping.
Connecting a mailbox
Once credentials are saved, each user connects their own mailbox from Settings → Profile → Connected accounts. Brixit reads only the messages it needs to thread against contacts.