Menu

Webhooks

Retrieves Inbound Parse Webhook statistics.

Retrieves Inbound Parse Webhook statistics.

GET /user/webhooks/parse/stats

This endpoint allows you to retrieve the statistics for your Parse Webhook useage.

SendGrid's Inbound Parse Webhook allows you to parse the contents and attachments of incomming emails. The Parse API can then POST the parsed emails to a URL that you specify. The Inbound Parse Webhook cannot parse messages greater than 30MB in size, including all attachments.

There are a number of pre-made integrations for the SendGrid Parse Webhook which make processing events easy. You can find these integrations in the Library Index.

Authentication

  • API Key

Headers

Authorization
string
default: Bearer <<YOUR_API_KEY_HERE>>
required
on-behalf-of
string
default: The subuser's username. This header generates the API call as if the subuser account was making the call.

Query String

limit
integer

The number of results to return.

offset
integer

The point in the list to begin retrieving results.

aggregated_by
string

How to group the statistics. Must be either "day", "week", or "month".

Allowed Values: day, week, month
start_date
string

The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD.

required
end_date
string

The end date of the statistics to retrieve. Defaults to today. Must follow format YYYY-MM-DD.

Responses

array[object]
date
string

The date that the stats were collected.

stats
array[object]

The Parse Webhook usage statistics.

metrics
object
received
number

The number of emails received and parsed by the Parse Webhook.

required

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.