Hosted Mail

If you are a pro/enterprise user, you have access to multiple different ways to send emails from Invoice Ninja. We offer OAuth integrations with both Google and Microsoft allowing you to send emails from your own email address.

Send with Gmail / Microsoft

Connecting either Gmail or Microsoft involves the same steps. Below is a short video showing the steps.

Note: Both the initial authentication and the connection to Gmail must use the same OAuth account. ie if you attempt to connect you must select this email address for authenticating with Google, and then also allow permissions for this email address to send email. Cross account linking is not possible.

Once you have connected your OAuth account, you can select either Gmail or Microsoft as the Email Provider in

Settings / Email Settings

alt text

After selecting the email provider, you'll then want to select the user who has been authenticated to send emails from the field beneath this.

Send with Postmark

If you prefer to send bulk emails via PostMark, then this is also supported. We do not throttle the outbound emails using Postmark, so this is suitable if you require a high throughput email service.

alt text

Simply add your Postmark API token to the configuration in

Settings / Email Settings

Warning! You must configure a sender signature in Postmark, else Postmark will reject all email attempts. To do this, ensure the email address of your primary user in Invoice Ninja matches the Sender Signature you configured in Postmark

Send with Mailgun

If you prefer to send bulk emails via Mailgun, then this is also supported. We do not throttle the outbound emails using Mailgun, so this is suitable if you require a high throughput email service.

alt text

Ensure to fill in both your Mailgun Secret and Domain that has been configured.

Handling Spam / Contacts unsubscribing from your emails.

Email delivery is hard the large email providers such as GMail, Yahoo, Microsoft are continuing their fight against unsolicited / spam emails from filling the inboxes that they serve.

In 2024 it will become even harder with additional checks in place on all emails to ensure that only high quality emails arrive to a users inbox.

In particular, their focus is on working unsubscribe links within emails. Previously we have not needed to insert an unsubscribe link into an invoice email, however now it will become a standard part of all outbound emails to include a unsubscribe link.

All ourbound emails that are sent from the Invoice Ninja Hosted Mail Service ( and will now contain a working unsubscribe link. If you are sending via your own provider (PostMark / MailGun / GMail / Microsoft) we will not be injecting these unsubscribe links into your emails.

If your client clicks on an unsubscribe link, they'll be taken to a page where they can opt out of receiving emails from you. This will mark their client record as "DO NOT SEND" and you will also receive a follow up email advising that this action has been taken by your client.

For more information, you can read this great article from Postmark

Want to contribute? Edit this page on GitHub!