Twilio SendGrid

Use the Twilio SendGrid integration to send emails through Twilio SendGrid's scalable email service using Bloomreach Engagement. You can find the integration in Integrations > + Add new integration.

For more details on working with emails in Bloomreach Engagement, see Working with emails.

How to set up the integration

Create a Twilio SendGrid account

To set up the integration, you'll need a Twilio SendGrid account. Contact your CSM if you don’t have one—they can help you create it.

📘

Already have a Twilio SendGrid account?

We still recommend setting up a separate account just for Bloomreach Engagement. Shared accounts send webhook status updates for all emails, which can affect privacy and performance.

You will also need:

• API Key ID: Your unique 69-character API Key ID to authenticate access to your Twilio SendGrid account.
• IP pool name (optional): An existing IP pool you want to use.

What's an IP pool?

IP pools are groups of dedicated IP addresses used to improve email deliverability by separating different types of email traffic.

Authenticate your domain in Twilio SendGrid

Domain Authentication is required to improve deliverability and build trust with inbox providers and recipients.

To authenticate your domain:

1. In Twilio SendGrid, go to Settings > Sender Authentication.
2. Click Authenticate Your Domain > Get Started.
3. Follow the steps in your account.

You'll need access to your DNS host. If needed, ask your technical team for help.

⏱️

Allow time for domain verification

Verification usually takes under an hour but may take longer.

Create an API key

1. In Twilio SendGrid, go to Settings > API Keys.
2. Click Create API Key.

3. Name your key.
   1. We recommend including the word "Bloomreach" when setting your API Key name so that you don't delete it by accident.
4. Set permissions to Full Access.
5. Click Create & View.

❗️

Important

Copy your API key right away—it’s only shown once. Store it somewhere safe as we won't be able to retrieve or restore it.

Add Twilio SendGrid Email integration

1. In your Bloomreach project, go to Data & Assets > Integrations > + Add new integration.
2. Search for Twilio SendGrid, then click + Add integration.

Enter the API key

Fill in the integration fields:

1. Paste the API Key you copied from Twilio SendGrid.
2. (Optional) Add if you're using an IP pool.
3. Make sure Handle webhooks automatically is checked.
4. Click Save integration.

🚧

Reusing API keys across projects is not recommended

Bloomreach Engagement allows you to use the same mail API key in multiple integrations even in multiple projects. However, if multiple projects share the same key, deleting one integration deletes the webhook and disables tracking for all of them.

(Optional) Webhook configuration

If you didn’t enable automatic webhook handling:

1. In your integration settings, copy your unique tracking webhook URL.
2. In Twilio SendGrid, go to Settings > Mail Settings > Event Webhooks.

3. Click Create new webhook.

4. Paste the URL into all required fields.

You can now use Bloomreach Engagement to send signed emails from your own domains using Twilio SendGrid.

For details on webhook setup, see Webhooks.

Default email provider

For details on how to set this integration as your default email provider, see Default email settings.