SendGrid Integration Guide

On this page

• Understanding the SendGrid integration
• What this integration does
• What this integration does not do
• Which emails use the producer SendGrid account
• Connecting your SendGrid account
• Managing your integration
• Important notes
• Scribe

Vinoshipper integrates with SendGrid to give producers control over their transactional email delivery. By connecting your own SendGrid account, emails sent to your customers come from your domain and sender identity instead of the default Vinoshipper platform account.

SendGrid is an email delivery platform that handles the reliable sending of transactional emails like order confirmations, shipping notifications, and club communications.

Understanding the SendGrid integration

By default, all transactional emails from Vinoshipper are sent through the platform's shared SendGrid account. When you connect your own SendGrid account, eligible emails are sent through your account instead, using your configured sender name and email address.

If your SendGrid account becomes unavailable (for example, if your API key expires or is revoked), the system automatically falls back to the default Vinoshipper email (do-not-reply@mail.vinoshipper.com) so your customers still receive their emails.

What this integration does

• Sends eligible transactional emails from your own SendGrid account
• Uses your configured sender name and email address on outgoing emails
• Validates that your API key has the required permissions before saving
• Falls back to the platform account if your account becomes unavailable

What this integration does not do

• This does not replace marketing email tools like Klaviyo or Mailchimp
• This does not give you access to send custom or bulk marketing emails through Vinoshipper
• This does not change the content or templates of transactional emails, only the sender identity

Which emails use the producer SendGrid account

Not all emails sent by Vinoshipper are eligible to go through your SendGrid account. Emails that are sent directly to your customers on your behalf are eligible. Platform-level emails, internal system notifications, and emails related to multi-winery orders remain on the platform account.

Examples of eligible emails include order confirmations and club processing communications. Shipping and delivery notifications are currently still sent through the platform account.

Connecting your SendGrid account

The integration is managed from your producer account under the integrations settings page.

To connect, you will need:

• A SendGrid API key with the mail.send permission
• A verified sender email address in your SendGrid account
• A sender display name

The system validates your API key during setup to confirm it is authentic and has the correct permissions. If the key is missing the mail.send scope, the connection will not be saved.

Managing your integration

Once connected, the integrations page shows your connection status, masked API key (last 4 characters), sender email, sender name, and the date you connected.

From this page you can:

• Validate your existing API key to confirm it is still working
• Disconnect your SendGrid account to return to the platform default
• Update your integration by disconnecting and reconnecting with new credentials
  
  

Important notes

• Your API key is stored encrypted and is never exposed in full through the interface or API
• You must have a verified sender identity in SendGrid that matches the sender email you configure
• If your API key becomes invalid, emails will still be delivered through the platform account
• Disconnecting your SendGrid account takes effect immediately and all future emails will use the platform account
• Emails may go to Spam if you do not set up the DNS configurations in SendGrid.

Scribe