Event Webhooks

POST

Describes a webhook invocation for an event from DevRev to a webhook’s target URL, where the receiving handler must implement the specified protocol. Note the documented endpoint is for exposition and not provided by DevRev.

Request

This endpoint expects an object.
typeenumRequired

The event types that the webhook will receive.

account_createdobjectRequired
account_deletedobjectRequired
account_updatedobjectRequired
ai_agent_responseobjectRequired
conversation_createdobjectRequired
conversation_deletedobjectRequired
conversation_updatedobjectRequired
dev_user_createdobjectRequired
dev_user_deletedobjectRequired
dev_user_updatedobjectRequired
group_createdobjectRequired
group_deletedobjectRequired
group_member_addedobjectRequired
group_member_removedobjectRequired
group_updatedobjectRequired
idstringRequired

The event’s ID.

incident_createdobjectRequired
incident_deletedobjectRequired
incident_updatedobjectRequired
part_createdobjectRequired
part_deletedobjectRequired
part_updatedobjectRequired
question_answer_createdobjectRequired
question_answer_deletedobjectRequired
question_answer_updatedobjectRequired
rev_org_createdobjectRequired
rev_org_deletedobjectRequired
rev_org_updatedobjectRequired
rev_user_createdobjectRequired
rev_user_deletedobjectRequired
rev_user_updatedobjectRequired
sla_tracker_createdobjectRequired
sla_tracker_deletedobjectRequired
sla_tracker_updatedobjectRequired
survey_createdobjectRequired
survey_deletedobjectRequired
survey_response_createdobjectRequired
survey_response_deletedobjectRequired
survey_response_updatedobjectRequired
survey_updatedobjectRequired
sync_history_createdobjectRequired
sync_history_deletedobjectRequired
sync_history_updatedobjectRequired
tag_createdobjectRequired
tag_deletedobjectRequired
tag_updatedobjectRequired
timeline_entry_createdobjectRequired
timeline_entry_deletedobjectRequired
timeline_entry_updatedobjectRequired
verifyobjectRequired
webhook_createdobjectRequired
webhook_deletedobjectRequired
webhook_idstringRequired

ID of the webhook for the event.

webhook_updatedobjectRequired
work_createdobjectRequired
work_deletedobjectRequired
work_fetchedobjectRequired
work_updatedobjectRequired
timestampstringOptionalformat: "date-time"

Timestamp of the webhook’s invocation for the event. Note this should be used to protect against replay attacks, where the event should only be processed if the timestamp isn’t stale by several seconds.

Response

Success.

challengestringOptionalformat: "byte"

The challenge from the “verify” request, otherwise this should not be set for other request types.

Built with