project_card

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

Github Event project_card #

Github Action Trigger #

source

Webhook event payloadActivity typesGITHUB_SHAGITHUB_REF
project_cardcreated
moved
converted to an issue
edited
deleted
Last commit on default branchDefault branch

Note: More than one activity type triggers this event. For information about each activity type, see “Webhook events and payloads.” By default, all activity types trigger workflows that run on this event. You can limit your workflow runs to specific activity types using the types keyword. For more information, see “Workflow syntax for GitHub Actions.”

Note: This event will only trigger a workflow run if the workflow file is on the default branch.

Note: This event only occurs for projects owned by the workflow’s repository, not for organization-owned or user-owned projects or for projects owned by another repository.

Note: This event only occurs for projects (classic).

Runs your workflow when a card on a project (classic) is created or modified. For activity related to projects (classic) or columns in a project (classic), use the project or project_column event instead. For more information about projects (classic), see “About projects (classic).” For information about the project card APIs, see “Objects” in the GraphQL API documentation or “Projects (classic)” in the REST API documentation.

For example, you can run a workflow when a project card has been created or deleted.

on:
  project_card:
    types: [created, deleted]

Event Payload #

source

Activities: converted, created, deleted, edited, moved

Common Fields #

These fields are common to every event types available with this trigger.
fieldtyperequireddescription
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.project_cardobjectrequired
github.event.project_card.archivedbooleanrequired

Whether or not the card is archived

github.event.project_card.column_urlstringrequired
github.event.project_card.content_urlstringoptional
github.event.project_card.created_atstringrequired
github.event.project_card.creatorobject or nullrequired
github.event.project_card.creator.avatar_urlstringoptional
github.event.project_card.creator.deletedbooleanoptional
github.event.project_card.creator.emailstring or nulloptional
github.event.project_card.creator.events_urlstringoptional
github.event.project_card.creator.followers_urlstringoptional
github.event.project_card.creator.following_urlstringoptional
github.event.project_card.creator.gists_urlstringoptional
github.event.project_card.creator.gravatar_idstringoptional
github.event.project_card.creator.html_urlstringoptional
github.event.project_card.creator.idintegerrequired
github.event.project_card.creator.loginstringrequired
github.event.project_card.creator.namestringoptional
github.event.project_card.creator.node_idstringoptional
github.event.project_card.creator.organizations_urlstringoptional
github.event.project_card.creator.received_events_urlstringoptional
github.event.project_card.creator.repos_urlstringoptional
github.event.project_card.creator.site_adminbooleanoptional
github.event.project_card.creator.starred_urlstringoptional
github.event.project_card.creator.subscriptions_urlstringoptional
github.event.project_card.creator.urlstringoptional
github.event.project_card.idintegerrequired

The project card’s ID

github.event.project_card.node_idstringrequired
github.event.project_card.notestring or nullrequired
github.event.project_card.project_urlstringrequired
github.event.project_card.updated_atstringrequired
github.event.project_card.urlstringrequired
github.event.repositoryobjectoptional

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.

converted #

This event occurs when there is activity relating to a card on a project (classic). For more information, see "About projects (classic)." For information about the API to manage classic projects, see the GraphQL API documentation or "Projects (classic)" in the REST API documentation.

For activity relating to a project (classic) or a column on a project (classic), use the project and project_column event.

This event relates to projects (classic) only. For activity relating to the new Projects experience, use the projects_v2 event instead.

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

fieldtyperequireddescription
github.event.actionconvertedrequired
github.event.changesobjectrequired
github.event.changes.noteobjectrequired
github.event.changes.note.fromstringrequired
github.event.project_card.after_idinteger or nulloptional
github.event.project_card.column_idintegerrequired
github.event.project_card.creator.typeBot, User, Organizationoptional

created #

This event occurs when there is activity relating to a card on a project (classic). For more information, see "About projects (classic)." For information about the API to manage classic projects, see the GraphQL API documentation or "Projects (classic)" in the REST API documentation.

For activity relating to a project (classic) or a column on a project (classic), use the project and project_column event.

This event relates to projects (classic) only. For activity relating to the new Projects experience, use the projects_v2 event instead.

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

fieldtyperequireddescription
github.event.actioncreatedrequired
github.event.project_card.after_idinteger or nulloptional
github.event.project_card.column_idintegerrequired
github.event.project_card.creator.typeBot, User, Organizationoptional

deleted #

This event occurs when there is activity relating to a card on a project (classic). For more information, see "About projects (classic)." For information about the API to manage classic projects, see the GraphQL API documentation or "Projects (classic)" in the REST API documentation.

For activity relating to a project (classic) or a column on a project (classic), use the project and project_column event.

This event relates to projects (classic) only. For activity relating to the new Projects experience, use the projects_v2 event instead.

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

fieldtyperequireddescription
github.event.actiondeletedrequired
github.event.project_card.after_idinteger or nulloptional
github.event.project_card.column_idinteger or nullrequired
github.event.project_card.creator.typeBot, User, Organization, Mannequinoptional

edited #

This event occurs when there is activity relating to a card on a project (classic). For more information, see "About projects (classic)." For information about the API to manage classic projects, see the GraphQL API documentation or "Projects (classic)" in the REST API documentation.

For activity relating to a project (classic) or a column on a project (classic), use the project and project_column event.

This event relates to projects (classic) only. For activity relating to the new Projects experience, use the projects_v2 event instead.

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

fieldtyperequireddescription
github.event.actioneditedrequired
github.event.changesobjectrequired
github.event.changes.noteobjectrequired
github.event.changes.note.fromstring or nullrequired
github.event.project_card.after_idinteger or nulloptional
github.event.project_card.column_idintegerrequired
github.event.project_card.creator.typeBot, User, Organizationoptional

moved #

This event occurs when there is activity relating to a card on a project (classic). For more information, see "About projects (classic)." For information about the API to manage classic projects, see the GraphQL API documentation or "Projects (classic)" in the REST API documentation.

For activity relating to a project (classic) or a column on a project (classic), use the project and project_column event.

This event relates to projects (classic) only. For activity relating to the new Projects experience, use the projects_v2 event instead.

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

fieldtyperequireddescription
github.event.actionmovedrequired
github.event.changesobjectoptional
github.event.changes.column_idobjectrequired
github.event.changes.column_id.fromintegerrequired
github.event.project_card.after_idnumber or nullrequired
github.event.project_card.column_idintegerrequired
github.event.project_card.creator.typeBot, User, Organization, Mannequinoptional