GitHub Integration

Zephyr documentation

How GitHub Integration Works

Zephyr can create GitHub issues and search repositories as workflow actions. When a workflow triggers, the 'Create GitHub Issue' action creates an issue in a specified repository with the email content or AI-processed result as the issue body.

Setting Up GitHub

1) Go to https://github.com/settings/developers and create a new OAuth App.

2
Set the callback URL to your Zephyr API URL + /connectors/github/callback.
3
Copy the Client ID and Client Secret.
4
Add them as SSM parameters: /zephyr/prod/github-client-id and /zephyr/prod/github-client-secret.
5
Deploy Zephyr.
6
In Settings > Connected Services, click Connect on the GitHub card.

Creating GitHub Workflows

Example: 'When I get a bug report email, create a GitHub issue in myorg/myrepo'. The AI generates a workflow with github_issue action specifying the owner and repo. You can also chain AI actions: 'summarize the email and create a GitHub issue with the summary'.