Deployment

This page was generated based on Github’s Documentation. See our welcome page for context and details.

Github Event deployment #

Github Action Trigger #

source

Webhook event payloadActivity typesGITHUB_SHAGITHUB_REF
deploymentNot applicableCommit to be deployedBranch or tag to be deployed (empty if created with a commit SHA)

Runs your workflow when someone creates a deployment in the workflow’s repository. Deployments created with a commit SHA may not have a Git ref. For information about the APIs to create a deployment, see “Mutations” in the GraphQL API documentation or “REST API endpoints for repositories.”

For example, you can run a workflow when the deployment event occurs.

on:
  deployment

Event Payload #

source

Activities: created

Common Fields #

These fields are common to every event types available with this trigger.
fieldtyperequireddescription
github.event.actioncreatedrequired
github.event.deploymentobjectrequired

The deployment.

github.event.deployment.created_atstringrequired
github.event.deployment.creatorobject or nullrequired
github.event.deployment.creator.avatar_urlstringoptional
github.event.deployment.creator.deletedbooleanoptional
github.event.deployment.creator.emailstring or nulloptional
github.event.deployment.creator.events_urlstringoptional
github.event.deployment.creator.followers_urlstringoptional
github.event.deployment.creator.following_urlstringoptional
github.event.deployment.creator.gists_urlstringoptional
github.event.deployment.creator.gravatar_idstringoptional
github.event.deployment.creator.html_urlstringoptional
github.event.deployment.creator.idintegerrequired
github.event.deployment.creator.loginstringrequired
github.event.deployment.creator.namestringoptional
github.event.deployment.creator.node_idstringoptional
github.event.deployment.creator.organizations_urlstringoptional
github.event.deployment.creator.received_events_urlstringoptional
github.event.deployment.creator.repos_urlstringoptional
github.event.deployment.creator.site_adminbooleanoptional
github.event.deployment.creator.starred_urlstringoptional
github.event.deployment.creator.subscriptions_urlstringoptional
github.event.deployment.creator.typeBot, User, Organizationoptional
github.event.deployment.creator.urlstringoptional
github.event.deployment.descriptionstring or nullrequired
github.event.deployment.environmentstringrequired
github.event.deployment.idintegerrequired
github.event.deployment.node_idstringrequired
github.event.deployment.original_environmentstringrequired
github.event.deployment.payloadobject or stringrequired
github.event.deployment.performed_via_github_appobject or nulloptional

GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. GitHub apps are first class actors within GitHub.

github.event.deployment.performed_via_github_app.created_atstring or nullrequired
github.event.deployment.performed_via_github_app.descriptionstring or nullrequired
github.event.deployment.performed_via_github_app.eventsarray of stringsoptional

The list of events for the GitHub app Supported values are: branch_protection_rule, check_run, check_suite, code_scanning_alert, commit_comment, content_reference, create, delete, deployment, deployment_review, deployment_status, deploy_key, discussion, discussion_comment, fork, gollum, issues, issue_comment, label, member, membership, milestone, organization, org_block, page_build, project, project_card, project_column, public, pull_request, pull_request_review, pull_request_review_comment, push, registry_package, release, repository, repository_dispatch, secret_scanning_alert, star, status, team, team_add, watch, workflow_dispatch, workflow_run, workflow_job, pull_request_review_thread, merge_queue_entry, secret_scanning_alert_location, merge_group

github.event.deployment.performed_via_github_app.external_urlstring or nullrequired
github.event.deployment.performed_via_github_app.html_urlstringrequired
github.event.deployment.performed_via_github_app.idinteger or nullrequired

Unique identifier of the GitHub app

github.event.deployment.performed_via_github_app.namestringrequired

The name of the GitHub app

github.event.deployment.performed_via_github_app.node_idstringrequired
github.event.deployment.performed_via_github_app.ownerobject or nullrequired
github.event.deployment.performed_via_github_app.owner.avatar_urlstringoptional
github.event.deployment.performed_via_github_app.owner.deletedbooleanoptional
github.event.deployment.performed_via_github_app.owner.emailstring or nulloptional
github.event.deployment.performed_via_github_app.owner.events_urlstringoptional
github.event.deployment.performed_via_github_app.owner.followers_urlstringoptional
github.event.deployment.performed_via_github_app.owner.following_urlstringoptional
github.event.deployment.performed_via_github_app.owner.gists_urlstringoptional
github.event.deployment.performed_via_github_app.owner.gravatar_idstringoptional
github.event.deployment.performed_via_github_app.owner.html_urlstringoptional
github.event.deployment.performed_via_github_app.owner.idintegerrequired
github.event.deployment.performed_via_github_app.owner.loginstringrequired
github.event.deployment.performed_via_github_app.owner.namestringoptional
github.event.deployment.performed_via_github_app.owner.node_idstringoptional
github.event.deployment.performed_via_github_app.owner.organizations_urlstringoptional
github.event.deployment.performed_via_github_app.owner.received_events_urlstringoptional
github.event.deployment.performed_via_github_app.owner.repos_urlstringoptional
github.event.deployment.performed_via_github_app.owner.site_adminbooleanoptional
github.event.deployment.performed_via_github_app.owner.starred_urlstringoptional
github.event.deployment.performed_via_github_app.owner.subscriptions_urlstringoptional
github.event.deployment.performed_via_github_app.owner.typeBot, User, Organizationoptional
github.event.deployment.performed_via_github_app.owner.urlstringoptional
github.event.deployment.performed_via_github_app.permissionsobjectoptional

The set of permissions for the GitHub app

github.event.deployment.performed_via_github_app.permissions.actionsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.administrationread, writeoptional
github.event.deployment.performed_via_github_app.permissions.checksread, writeoptional
github.event.deployment.performed_via_github_app.permissions.content_referencesread, writeoptional
github.event.deployment.performed_via_github_app.permissions.contentsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.deploymentsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.discussionsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.emailsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.environmentsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.issuesread, writeoptional
github.event.deployment.performed_via_github_app.permissions.keysread, writeoptional
github.event.deployment.performed_via_github_app.permissions.membersread, writeoptional
github.event.deployment.performed_via_github_app.permissions.metadataread, writeoptional
github.event.deployment.performed_via_github_app.permissions.organization_administrationread, writeoptional
github.event.deployment.performed_via_github_app.permissions.organization_hooksread, writeoptional
github.event.deployment.performed_via_github_app.permissions.organization_packagesread, writeoptional
github.event.deployment.performed_via_github_app.permissions.organization_planread, writeoptional
github.event.deployment.performed_via_github_app.permissions.organization_projectsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.organization_secretsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.organization_self_hosted_runnersread, writeoptional
github.event.deployment.performed_via_github_app.permissions.organization_user_blockingread, writeoptional
github.event.deployment.performed_via_github_app.permissions.packagesread, writeoptional
github.event.deployment.performed_via_github_app.permissions.pagesread, writeoptional
github.event.deployment.performed_via_github_app.permissions.pull_requestsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.repository_hooksread, writeoptional
github.event.deployment.performed_via_github_app.permissions.repository_projectsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.secret_scanning_alertsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.secretsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.security_eventsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.security_scanning_alertread, writeoptional
github.event.deployment.performed_via_github_app.permissions.single_fileread, writeoptional
github.event.deployment.performed_via_github_app.permissions.statusesread, writeoptional
github.event.deployment.performed_via_github_app.permissions.team_discussionsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.vulnerability_alertsread, writeoptional
github.event.deployment.performed_via_github_app.permissions.workflowsread, writeoptional
github.event.deployment.performed_via_github_app.slugstringoptional

The slug name of the GitHub app

github.event.deployment.performed_via_github_app.updated_atstring or nullrequired
github.event.deployment.production_environmentbooleanoptional
github.event.deployment.refstringrequired
github.event.deployment.repository_urlstringrequired
github.event.deployment.shastringrequired
github.event.deployment.statuses_urlstringrequired
github.event.deployment.taskstringrequired
github.event.deployment.transient_environmentbooleanoptional
github.event.deployment.updated_atstringrequired
github.event.deployment.urlstringrequired
github.event.enterpriseobjectoptional

An enterprise on GitHub. Webhook payloads contain the enterprise property when the webhook is configured on an enterprise account or an organization that’s part of an enterprise account. For more information, see “About enterprise accounts."

github.event.installationobjectoptional

The GitHub App installation. Webhook payloads contain the installation property when the event is configured for and sent to a GitHub App. For more information, see “Using webhooks with GitHub Apps."

github.event.organizationobjectoptional

A GitHub organization. Webhook payloads contain the organization property when the webhook is configured for an organization, or when the event occurs from activity in a repository owned by an organization.

github.event.repositoryobjectrequired

The repository on GitHub where the event occurred. Webhook payloads contain the repository property when the event occurs from activity in a repository.

github.event.senderobjectrequired

The GitHub user that triggered the event. This property is included in every webhook payload.

github.event.workflowobject or nullrequired
github.event.workflow.badge_urlstringrequired
github.event.workflow.created_atstringrequired
github.event.workflow.html_urlstringrequired
github.event.workflow.idintegerrequired
github.event.workflow.namestringrequired
github.event.workflow.node_idstringrequired
github.event.workflow.pathstringrequired
github.event.workflow.statestringrequired
github.event.workflow.updated_atstringrequired
github.event.workflow.urlstringrequired
github.event.workflow_runobject or nullrequired
github.event.workflow_run.actorobject or nullrequired
github.event.workflow_run.actor.avatar_urlstringoptional
github.event.workflow_run.actor.deletedbooleanoptional
github.event.workflow_run.actor.emailstring or nulloptional
github.event.workflow_run.actor.events_urlstringoptional
github.event.workflow_run.actor.followers_urlstringoptional
github.event.workflow_run.actor.following_urlstringoptional
github.event.workflow_run.actor.gists_urlstringoptional
github.event.workflow_run.actor.gravatar_idstringoptional
github.event.workflow_run.actor.html_urlstringoptional
github.event.workflow_run.actor.idintegerrequired
github.event.workflow_run.actor.loginstringrequired
github.event.workflow_run.actor.namestringoptional
github.event.workflow_run.actor.node_idstringoptional
github.event.workflow_run.actor.organizations_urlstringoptional
github.event.workflow_run.actor.received_events_urlstringoptional
github.event.workflow_run.actor.repos_urlstringoptional
github.event.workflow_run.actor.site_adminbooleanoptional
github.event.workflow_run.actor.starred_urlstringoptional
github.event.workflow_run.actor.subscriptions_urlstringoptional
github.event.workflow_run.actor.typeBot, User, Organizationoptional
github.event.workflow_run.actor.urlstringoptional
github.event.workflow_run.artifacts_urlstringoptional
github.event.workflow_run.cancel_urlstringoptional
github.event.workflow_run.check_suite_idintegerrequired
github.event.workflow_run.check_suite_node_idstringrequired
github.event.workflow_run.check_suite_urlstringoptional
github.event.workflow_run.conclusionsuccess, failure, neutral, cancelled, timed_out, action_required, stale, Nonerequired
github.event.workflow_run.created_atstringrequired
github.event.workflow_run.display_titlestringrequired
github.event.workflow_run.eventstringrequired
github.event.workflow_run.head_branchstringrequired
github.event.workflow_run.head_commitnulloptional
github.event.workflow_run.head_repositoryobjectoptional
github.event.workflow_run.head_repository.archive_urlstringoptional
github.event.workflow_run.head_repository.assignees_urlstringoptional
github.event.workflow_run.head_repository.blobs_urlstringoptional
github.event.workflow_run.head_repository.branches_urlstringoptional
github.event.workflow_run.head_repository.collaborators_urlstringoptional
github.event.workflow_run.head_repository.comments_urlstringoptional
github.event.workflow_run.head_repository.commits_urlstringoptional
github.event.workflow_run.head_repository.compare_urlstringoptional
github.event.workflow_run.head_repository.contents_urlstringoptional
github.event.workflow_run.head_repository.contributors_urlstringoptional
github.event.workflow_run.head_repository.deployments_urlstringoptional
github.event.workflow_run.head_repository.descriptionnulloptional
github.event.workflow_run.head_repository.downloads_urlstringoptional
github.event.workflow_run.head_repository.events_urlstringoptional
github.event.workflow_run.head_repository.forkbooleanoptional
github.event.workflow_run.head_repository.forks_urlstringoptional
github.event.workflow_run.head_repository.full_namestringoptional
github.event.workflow_run.head_repository.git_commits_urlstringoptional
github.event.workflow_run.head_repository.git_refs_urlstringoptional
github.event.workflow_run.head_repository.git_tags_urlstringoptional
github.event.workflow_run.head_repository.hooks_urlstringoptional
github.event.workflow_run.head_repository.html_urlstringoptional
github.event.workflow_run.head_repository.idintegeroptional
github.event.workflow_run.head_repository.issue_comment_urlstringoptional
github.event.workflow_run.head_repository.issue_events_urlstringoptional
github.event.workflow_run.head_repository.issues_urlstringoptional
github.event.workflow_run.head_repository.keys_urlstringoptional
github.event.workflow_run.head_repository.labels_urlstringoptional
github.event.workflow_run.head_repository.languages_urlstringoptional
github.event.workflow_run.head_repository.merges_urlstringoptional
github.event.workflow_run.head_repository.milestones_urlstringoptional
github.event.workflow_run.head_repository.namestringoptional
github.event.workflow_run.head_repository.node_idstringoptional
github.event.workflow_run.head_repository.notifications_urlstringoptional
github.event.workflow_run.head_repository.ownerobjectoptional
github.event.workflow_run.head_repository.owner.avatar_urlstringoptional
github.event.workflow_run.head_repository.owner.events_urlstringoptional
github.event.workflow_run.head_repository.owner.followers_urlstringoptional
github.event.workflow_run.head_repository.owner.following_urlstringoptional
github.event.workflow_run.head_repository.owner.gists_urlstringoptional
github.event.workflow_run.head_repository.owner.gravatar_idstringoptional
github.event.workflow_run.head_repository.owner.html_urlstringoptional
github.event.workflow_run.head_repository.owner.idintegeroptional
github.event.workflow_run.head_repository.owner.loginstringoptional
github.event.workflow_run.head_repository.owner.node_idstringoptional
github.event.workflow_run.head_repository.owner.organizations_urlstringoptional
github.event.workflow_run.head_repository.owner.received_events_urlstringoptional
github.event.workflow_run.head_repository.owner.repos_urlstringoptional
github.event.workflow_run.head_repository.owner.site_adminbooleanoptional
github.event.workflow_run.head_repository.owner.starred_urlstringoptional
github.event.workflow_run.head_repository.owner.subscriptions_urlstringoptional
github.event.workflow_run.head_repository.owner.typestringoptional
github.event.workflow_run.head_repository.owner.urlstringoptional
github.event.workflow_run.head_repository.privatebooleanoptional
github.event.workflow_run.head_repository.pulls_urlstringoptional
github.event.workflow_run.head_repository.releases_urlstringoptional
github.event.workflow_run.head_repository.stargazers_urlstringoptional
github.event.workflow_run.head_repository.statuses_urlstringoptional
github.event.workflow_run.head_repository.subscribers_urlstringoptional
github.event.workflow_run.head_repository.subscription_urlstringoptional
github.event.workflow_run.head_repository.tags_urlstringoptional
github.event.workflow_run.head_repository.teams_urlstringoptional
github.event.workflow_run.head_repository.trees_urlstringoptional
github.event.workflow_run.head_repository.urlstringoptional
github.event.workflow_run.head_shastringrequired
github.event.workflow_run.html_urlstringrequired
github.event.workflow_run.idintegerrequired
github.event.workflow_run.jobs_urlstringoptional
github.event.workflow_run.logs_urlstringoptional
github.event.workflow_run.namestringrequired
github.event.workflow_run.node_idstringrequired
github.event.workflow_run.pathstringrequired
github.event.workflow_run.previous_attempt_urlnulloptional
github.event.workflow_run.pull_requestsarray of objectsrequired
github.event.workflow_run.pull_requests.baseobjectrequired
github.event.workflow_run.pull_requests.base.refstringrequired
github.event.workflow_run.pull_requests.base.repoobjectrequired
github.event.workflow_run.pull_requests.base.repo.idintegerrequired
github.event.workflow_run.pull_requests.base.repo.namestringrequired
github.event.workflow_run.pull_requests.base.repo.urlstringrequired
github.event.workflow_run.pull_requests.base.shastringrequired
github.event.workflow_run.pull_requests.headobjectrequired
github.event.workflow_run.pull_requests.head.refstringrequired
github.event.workflow_run.pull_requests.head.repoobjectrequired
github.event.workflow_run.pull_requests.head.repo.idintegerrequired
github.event.workflow_run.pull_requests.head.repo.namestringrequired
github.event.workflow_run.pull_requests.head.repo.urlstringrequired
github.event.workflow_run.pull_requests.head.shastringrequired
github.event.workflow_run.pull_requests.idintegerrequired
github.event.workflow_run.pull_requests.numberintegerrequired
github.event.workflow_run.pull_requests.urlstringrequired
github.event.workflow_run.referenced_workflowsarray of objects or nulloptional
github.event.workflow_run.referenced_workflows.pathstringrequired
github.event.workflow_run.referenced_workflows.refstringoptional
github.event.workflow_run.referenced_workflows.shastringrequired
github.event.workflow_run.repositoryobjectoptional
github.event.workflow_run.repository.archive_urlstringoptional
github.event.workflow_run.repository.assignees_urlstringoptional
github.event.workflow_run.repository.blobs_urlstringoptional
github.event.workflow_run.repository.branches_urlstringoptional
github.event.workflow_run.repository.collaborators_urlstringoptional
github.event.workflow_run.repository.comments_urlstringoptional
github.event.workflow_run.repository.commits_urlstringoptional
github.event.workflow_run.repository.compare_urlstringoptional
github.event.workflow_run.repository.contents_urlstringoptional
github.event.workflow_run.repository.contributors_urlstringoptional
github.event.workflow_run.repository.deployments_urlstringoptional
github.event.workflow_run.repository.descriptionnulloptional
github.event.workflow_run.repository.downloads_urlstringoptional
github.event.workflow_run.repository.events_urlstringoptional
github.event.workflow_run.repository.forkbooleanoptional
github.event.workflow_run.repository.forks_urlstringoptional
github.event.workflow_run.repository.full_namestringoptional
github.event.workflow_run.repository.git_commits_urlstringoptional
github.event.workflow_run.repository.git_refs_urlstringoptional
github.event.workflow_run.repository.git_tags_urlstringoptional
github.event.workflow_run.repository.hooks_urlstringoptional
github.event.workflow_run.repository.html_urlstringoptional
github.event.workflow_run.repository.idintegeroptional
github.event.workflow_run.repository.issue_comment_urlstringoptional
github.event.workflow_run.repository.issue_events_urlstringoptional
github.event.workflow_run.repository.issues_urlstringoptional
github.event.workflow_run.repository.keys_urlstringoptional
github.event.workflow_run.repository.labels_urlstringoptional
github.event.workflow_run.repository.languages_urlstringoptional
github.event.workflow_run.repository.merges_urlstringoptional
github.event.workflow_run.repository.milestones_urlstringoptional
github.event.workflow_run.repository.namestringoptional
github.event.workflow_run.repository.node_idstringoptional
github.event.workflow_run.repository.notifications_urlstringoptional
github.event.workflow_run.repository.ownerobjectoptional
github.event.workflow_run.repository.owner.avatar_urlstringoptional
github.event.workflow_run.repository.owner.events_urlstringoptional
github.event.workflow_run.repository.owner.followers_urlstringoptional
github.event.workflow_run.repository.owner.following_urlstringoptional
github.event.workflow_run.repository.owner.gists_urlstringoptional
github.event.workflow_run.repository.owner.gravatar_idstringoptional
github.event.workflow_run.repository.owner.html_urlstringoptional
github.event.workflow_run.repository.owner.idintegeroptional
github.event.workflow_run.repository.owner.loginstringoptional
github.event.workflow_run.repository.owner.node_idstringoptional
github.event.workflow_run.repository.owner.organizations_urlstringoptional
github.event.workflow_run.repository.owner.received_events_urlstringoptional
github.event.workflow_run.repository.owner.repos_urlstringoptional
github.event.workflow_run.repository.owner.site_adminbooleanoptional
github.event.workflow_run.repository.owner.starred_urlstringoptional
github.event.workflow_run.repository.owner.subscriptions_urlstringoptional
github.event.workflow_run.repository.owner.typestringoptional
github.event.workflow_run.repository.owner.urlstringoptional
github.event.workflow_run.repository.privatebooleanoptional
github.event.workflow_run.repository.pulls_urlstringoptional
github.event.workflow_run.repository.releases_urlstringoptional
github.event.workflow_run.repository.stargazers_urlstringoptional
github.event.workflow_run.repository.statuses_urlstringoptional
github.event.workflow_run.repository.subscribers_urlstringoptional
github.event.workflow_run.repository.subscription_urlstringoptional
github.event.workflow_run.repository.tags_urlstringoptional
github.event.workflow_run.repository.teams_urlstringoptional
github.event.workflow_run.repository.trees_urlstringoptional
github.event.workflow_run.repository.urlstringoptional
github.event.workflow_run.rerun_urlstringoptional
github.event.workflow_run.run_attemptintegerrequired
github.event.workflow_run.run_numberintegerrequired
github.event.workflow_run.run_started_atstringrequired
github.event.workflow_run.statusrequested, in_progress, completed, queued, waiting, pendingrequired
github.event.workflow_run.triggering_actorobject or nulloptional
github.event.workflow_run.triggering_actor.avatar_urlstringoptional
github.event.workflow_run.triggering_actor.deletedbooleanoptional
github.event.workflow_run.triggering_actor.emailstring or nulloptional
github.event.workflow_run.triggering_actor.events_urlstringoptional
github.event.workflow_run.triggering_actor.followers_urlstringoptional
github.event.workflow_run.triggering_actor.following_urlstringoptional
github.event.workflow_run.triggering_actor.gists_urlstringoptional
github.event.workflow_run.triggering_actor.gravatar_idstringoptional
github.event.workflow_run.triggering_actor.html_urlstringoptional
github.event.workflow_run.triggering_actor.idintegerrequired
github.event.workflow_run.triggering_actor.loginstringrequired
github.event.workflow_run.triggering_actor.namestringoptional
github.event.workflow_run.triggering_actor.node_idstringoptional
github.event.workflow_run.triggering_actor.organizations_urlstringoptional
github.event.workflow_run.triggering_actor.received_events_urlstringoptional
github.event.workflow_run.triggering_actor.repos_urlstringoptional
github.event.workflow_run.triggering_actor.site_adminbooleanoptional
github.event.workflow_run.triggering_actor.starred_urlstringoptional
github.event.workflow_run.triggering_actor.subscriptions_urlstringoptional
github.event.workflow_run.triggering_actor.typeBot, User, Organizationoptional
github.event.workflow_run.triggering_actor.urlstringoptional
github.event.workflow_run.updated_atstringrequired
github.event.workflow_run.urlstringrequired
github.event.workflow_run.workflow_idintegerrequired
github.event.workflow_run.workflow_urlstringoptional

created #

This event occurs when there is activity relating to deployments. For more information, see "About deployments." For information about the APIs to manage deployments, see the GraphQL API documentation or "Deployments" in the REST API documentation.

For activity relating to deployment status, use the deployment_status event.

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

fieldtyperequireddescription