SendGrid Webhook

Last updated on Feb 05, 2025
On This Page

Hevo can bring email activity data from your SendGrid account into your Destination. Hevo connects to SendGrid through Webhooks.

We have migrated our webhooks infrastructure for better scalability and throughput. As a result, the old Webhook URLs are deprecated and will stop working soon. Please migrate to the new webhook URL (provided in the Set up Webhook section of your Pipeline Overview page) to avoid disruption in your data loading operations.

new webhook notice

Prerequisites

Add Webhook URL in your SendGrid Account

  1. Copy the generated webhook URL.

  2. Go to your SendGrid account, open Settings > Mail Settings in the SendGrid UI.

  3. Turn on Event Notification.

  4. In the HTTP POST URL field, paste the unique URL that you copied in step 1.

  5. Select the Event notifications you would like to test.

  6. Click the checkmark in the top corner to save these updates into your settings.

You can read more about how Webhooks work in SendGrid here.

Sample Event Data:

{
    "email": "example@test.com",
    "timestamp": 1580102529,
    "smtp-id": "<14c5d75ce93.dfd.64b469@ismtpd-555>",
    "event": "deferred",
    "category": "cat facts",
    "sg_event_id": "P0onudGCXGlIhfAoy831Nw==",
    "sg_message_id": "14c5d75ce93.dfd.64b469.filter0001.16648.5515E0B88.0",
    "response": "400 try again later",
    "attempt": "5"
}


Limitations

  • Hevo does not load an Event into the Destination table if its size exceeds 128 MB, which may lead to discrepancies between your Source and Destination data. To avoid such a scenario, ensure that each row in your Source objects contains less than 100 MB of data.

See Also

Revision History

Refer to the following table for the list of key updates made to this page:

Date Release Description of Change
Jan-07-2025 NA Added a limitation about Event size.
Was this page helpful?

Tell us what went wrong