How to link with SendGrid

By linking Kuroco with SendGrid, you can set the reply and the notification email from the system to any email address.
Without SendGrid, the notification email address will be "noreply@kuroco-mail.app".

This tutorial explains how to integrate with SendGrid on the Kuroco management page and how to change the email address.

Note: Due to changes in the SendGrid specifications, the SendGrid API KEY acquisition method may differ from this tutorial. For details, please check the latest information on Send Grid.

SendGrid's setting

1. Create an account

First, check the plan on SendGrid and create your account.
Image (fetched from Gyazo)

2. Authenticate sending domain

Set up domain authentication referring to SendGrid tutorial and set up domain authentication.

After login your dashboard page, access [Settings] -> [Sender Authentication] and click [Get started] in the domain authentication section.
Image (fetched from Gyazo)

Select the DNS host you are using on 1, select "Yes" for 2(link branding) and click [Next].
Image (fetched from Gyazo)

Enter the domain to be authenticated and click [Next].
Image (fetched from Gyazo)

The DNS records that need to be set will be displayed. Image (fetched from Gyazo)

Add these DNS records to your domain's DNS.
Image (fetched from Gyazo) After adding records in DNS, wait until they are reflected. It can take a max of 48 hours.

After the DNS setting is reflected, check [I'v added these records.] and click [Verify].
Image (fetched from Gyazo)

If the below screen appears the domain authentication is complete.
Image (fetched from Gyazo)

3. Confirm SendGrid APIKEY

Issue an API key referring to SendGrid tutorial.
On the dashboard, click [Settings] -> [API Keys] and click [Create API Key] on the top right of the screen.
Image (fetched from Gyazo)

Enter API Key Name, select Full Access, and click [Create & View].
Image (fetched from Gyazo)

If the below screen appears, the API key is issued properly.
Save the API Key because you cannot see it again after closing the page.
Image (fetched from Gyazo)

4. Disable Click Tracking

Access [Settings] -> [Tracking] and click 🖊️ icon next to "Click Tracking". Image (fetched from Gyazo)

On the setting page, click the [DISABLED ENABLED] slider and set it to [DISABLED], and click [Save].
Image (fetched from Gyazo)

If the message "Success! The Click Tracking setting has been updated." is shown and Click Tracking's status changes to Disabled, the setting is complete.
Image (fetched from Gyazo)

Kuroco's setting

From here, we will work on Kuroco's management page.

5. Integrate Kuroco with SendGrid

On the Kuroco's management page, click [External System Cooperation] -> [SendGrid] on the side menu.
Image (fetched from Gyazo)

Enter the SendGrid API key which you have generated at above "3. Confirm SendGrid API key" and click [Update].
Image (fetched from Gyazo)

Once the integration with SendGrid is completed, you will be able to add sending permission domains and email addresses.
And the domain which has been authenticated at "2. Authenticate sending domain" will be displayed.
Image (fetched from Gyazo)

6. Set the website e-mail address

Enter your preferred e-mail address in "website email address".
The e-mail address must be registered in the sending permission domain e-mail address, so if it is not registered, register it as well. Image (fetched from Gyazo)

Confirm the change of website e-mail address

7. Send an invitation e-mail

Send and invitation e-mail referring to Inviting new members.

8. Check the sender of the e-mail

Confirm that the sender of the e-mail is the website e-mail address that you have set above.
Image (fetched from Gyazo)

That's all for this tutorial.