We’re looking to potentially use webhooks to send data on certain types of events for metrics purposes. Are the payloads for these events listed anywhere, or are the webhook payloads identical to the ones in the Discourse API? For example, we may set up one for user events, and in that case would the payload contain all the standard user JSON returned in the /admin/users/list/{flag}.json endpoint, or would it be different? Same question for post events with the /posts.json endpoint, and topics with /latest.json. Along those lines, I know with the aforementioned user endpoint you can specify show_emails=true when using the API, so I was wondering - does the payload from the webhook include emails?

[image] hollyw: Are the payloads for these events listed anywhere, or are the webhook payloads identical to the ones in the Discourse API? I do not know of a list of the webhook payloads. The payloads are similar to what you see in the Discourse API documentation, but some fields are not included in the payload and in a few cases extra fields are added. The easiest way I know of to see what gets sent in the payload is to configure a webhook on Discourse to point to http://example.com and then perform an action on the site to trigger the webhook. You can then see the payload by clicking the “Request” button from the webhook’s events list: [image] That screenshot is for a User Event webhook. You’ll see that the user’s email address is included in the payload.

Webhook Payload

Product Support

hollyw (Holly W) July 8, 2020, 11:45pm 3

Thanks, I setup a test webhook and I’ve got my payloads now.

Topic		Replies	Views
Webhook for Discourse events Feature rfc	12	9264	October 22, 2016
Discourse Webhooks - Help Development	8	2310	February 26, 2018
Webhooks feedback Development	33	11452	March 21, 2017
Can you pass a user field value through a webhook? Product Support	4	1699	March 19, 2018
Webhook Event Documentation Feature	0	1013	April 12, 2022

Webhook Payload

Related topics