Skip to main content

Requirements

Before connecting Jira, ensure you have:
  • Jira Cloud — Ziggy works with Jira Cloud (not Jira Server or Data Center)
  • Jira permissions — You need permission to authorize third-party apps in your Jira instance

Connect via OAuth

1

Start the connection

In any Slack channel, type:
/ziggy connect
2

Authorize in Atlassian

Click the authorization link. You’ll be redirected to Atlassian to grant Ziggy access.Ziggy requests permission to:
  • Read and write issues
  • Read projects and issue types
  • Upload attachments
  • Read and write comments
3

Confirmation

Once authorized, Ziggy will confirm the connection in Slack and start your 14-day free trial.

Check connection status

To verify your Jira connection at any time:
/ziggy status
This shows:
  • Connection status
  • Connected Jira site
  • Default project (if set)
  • Subscription status and trial days remaining

Troubleshooting

Ensure you have permission to authorize third-party apps in your Jira instance. Contact your Jira admin if needed.
If you connected the wrong Jira instance, contact support@ziggy.sh to reset your connection.
Ziggy can only access projects that the authorizing user has access to. Make sure you have the necessary Jira permissions.

Security

  • Ziggy uses OAuth 2.0 for secure authentication
  • Credentials are encrypted at rest
  • Ziggy only accesses Jira when explicitly triggered by a user mention
  • All data is scoped to your workspace — no cross-tenant access