Webhooks
Test Event Notification Settings
POST /v3/user/webhooks/event/test
Base url: https://api.sendgrid.com
This endpoint allows you to test your event webhook by sending a fake event notification post to the provided URL.
SendGrid’s Event Webhook will notify a URL of your choice via HTTP POST with information about events that occur as SendGrid processes your email.
Common uses of this data are to remove unsubscribes, react to spam reports, determine unengaged recipients, identify bounced email addresses, or create advanced analytics of your email program.
Tip: Retry logic for this endpoint differs from other endpoints, which use a rolling 24-hour retry.
If your web server does not return a 2xx response type, we will retry a POST request until we receive a 2xx response or the maximum time of 10 minutes has expired.
Authentication
- API Key
Headers
Request Body
The URL where you would like the test notification to be sent.
The client ID Twilio SendGrid sends to your OAuth server or service provider to generate an OAuth access token. When passing data in this field, you must also include the oauth_client_secret and oauth_token_url fields.
This secret is needed only once to create an access token. SendGrid will store this secret, allowing you to update your Client ID and Token URL without passing the secret to SendGrid again. When passing data in this field, you must also include the oauth_client_id and oauth_token_url fields.
The URL where Twilio SendGrid sends the Client ID and Client Secret to generate an access token. This should be your OAuth server or service provider. When passing data in this field, you must also include the oauth_client_id and oauth_client_secret fields.
{
"url": "mollit non ipsum magna",
"oauth_client_id": "nisi",
"oauth_client_secret": "veniam commodo ex sunt",
"oauth_token_url": "dolor Duis"
}
Responses
Need some help?
We all do sometimes. Get help now from the Twilio SendGrid Support Team.
Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.