API ReferenceWebhooks

Event Webhooks

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.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
idstringRequiredformat: "id"
The event's ID.
webhook_idstringRequiredformat: "id"
ID of the webhook for the event.
typeenumOptional
The event types that the webhook will receive.
account_createdobjectOptional
account_deletedobjectOptional
account_updatedobjectOptional
ai_agent_responseobjectOptional
article_createdobjectOptional
article_deletedobjectOptional
article_updatedobjectOptional
conversation_createdobjectOptional
conversation_deletedobjectOptional
conversation_updatedobjectOptional
dashboard_createdobjectOptional
dashboard_deletedobjectOptional
dashboard_updatedobjectOptional
dev_user_createdobjectOptional
dev_user_deletedobjectOptional
dev_user_updatedobjectOptional
group_createdobjectOptional
group_deletedobjectOptional
group_member_addedobjectOptional
group_member_removedobjectOptional
group_updatedobjectOptional
incident_createdobjectOptional
incident_deletedobjectOptional
incident_updatedobjectOptional
part_createdobjectOptional
part_deletedobjectOptional
part_updatedobjectOptional
question_answer_createdobjectOptional
question_answer_deletedobjectOptional
question_answer_updatedobjectOptional
rev_org_createdobjectOptional
rev_org_deletedobjectOptional
rev_org_updatedobjectOptional
rev_user_createdobjectOptional
rev_user_deletedobjectOptional
rev_user_updatedobjectOptional
sla_tracker_createdobjectOptional
sla_tracker_deletedobjectOptional
sla_tracker_fetchedobjectOptional
sla_tracker_updatedobjectOptional
survey_createdobjectOptional
survey_deletedobjectOptional
survey_response_createdobjectOptional
survey_response_deletedobjectOptional
survey_response_updatedobjectOptional
survey_updatedobjectOptional
sync_history_createdobjectOptional
sync_history_deletedobjectOptional
sync_history_updatedobjectOptional
tag_createdobjectOptional
tag_deletedobjectOptional
tag_updatedobjectOptional
timeline_entry_createdobjectOptional
timeline_entry_deletedobjectOptional
timeline_entry_updatedobjectOptional
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.
verifyobjectOptional
webhook_createdobjectOptional
webhook_deletedobjectOptional
webhook_updatedobjectOptional
widget_createdobjectOptional
widget_deletedobjectOptional
widget_updatedobjectOptional
work_createdobjectOptional
work_deletedobjectOptional
work_fetchedobjectOptional
work_updatedobjectOptional

Response

Success.
challengestring or nullformat: "byte"
The challenge from the "verify" request, otherwise this should not be set for other request types.

Errors