Skip to main content

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 "No" for 2(link branding) and click [Next].
Image 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 from Gyazo Add these DNS records to your domain's DNS.
Image 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 from Gyazo If the below screen appears the domain authentication is complete.
Image (fetched from Gyazo)

info

In the case of SendGrid, authentication for SPF/DKIM is completed by configuring the three CNAME records mentioned above. Since this involves CNAME settings for a subdomain, it does not affect email sending from existing mail systems, and there is no need for modifications to existing SPF codes.

For more details, please refer to Understanding SPF and DKIM Authentication When Sending Emails via SendGrid.

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 Restricted 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)

5. Enable Event Webhook

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

On the setting page, set below and click [Save]

ItemValue
Authorization MethodNone
HTTP Post URLWebhook URL on the Kuroco's management page
DELIVERABILITY DATASelect All
ENGAGEMENT DATASelect All
Event Webhook StatusENABLED

HTTP Post URL can be confirmed at [External System Integration]->[SendGrid].

Image from Gyazo

If the message "Success! The Event Webhook setting has been updated." is shown and Event Webhook's status changes to Enabled, the setting is complete.

Image from Gyazo

Kuroco's setting

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

6. Integrate Kuroco with SendGrid

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

Check [Update], and enter the SendGrid APIKEY obtained in "3. Confirm SendGrid APIKEY", then click [Update].
Image from Gyazo

When the linkage with SendGrid is completed, the domain that was authenticated in "2. Authenticate the sending domain" will be displayed.
Image from Gyazo

7. Set the website e-mail address

Enter your preferred e-mail address in "Site e-mail address".
Image from Gyazo

Confirm the change of website e-mail address

8. Send an invitation e-mail

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

9. 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)

caution

When sending a large volume of emails immediately after integrating with SendGrid, the sent emails may be considered as spam and rejected by the recipients. To establish a positive reputation (trustworthiness of the email sender) for your IP address, it is recommended to start with a small to moderate volume of emails and gradually increase the quantity.
For more information, please refer to SendGrid's Warming Up an IP Address for details.


Support

If you have any other questions, please contact us or check out Our Slack Community.