Repository Dispatch

This event occurs when a GitHub App sends a POST request to /repos/{owner}/{repo}/dispatches. For more information, see the REST API documentation for creating a repository dispatch event. In the payload, the action will be the event_type that was specified in the POST /repos/{owner}/{repo}/dispatches request body.

Actions

ActionSent when
sample.collectedThis event occurs when a GitHub App sends a POST request to /repos/{owner}/{repo}/dispatches. For more information, see the REST API documentation for creating a repository dispatch event. In the payload, the action will be the event_type that was specified in the POST /repos/{owner}/{repo}/dispatches request body.

Payload

Fields of the delivery for the first action above. Every action shares the event's core fields.

FieldTypeRequiredDescription
actionstringYesThe event_type that was specified in the POST /repos/{owner}/{repo}/dispatches request body.
branchstringYes
client_payloadobjectYesThe client_payload that was specified in the POST /repos/{owner}/{repo}/dispatches request body.
enterpriseobjectNoAn enterprise on GitHub. Webhook payloads contain the enterprise property when the webhook is configured
installationobjectYesThe GitHub App installation. Webhook payloads contain the installation property when the event is configured
organizationobjectNoA GitHub organization. Webhook payloads contain the organization property when the webhook is configured for an
repositoryobjectYesThe repository on GitHub where the event occurred. Webhook payloads contain the repository property
senderobjectYesA GitHub user.
Subscribing

To subscribe to this event, a GitHub App must have at least read-level access for the "Contents" repository permission.