Add Integration

1 min read

Use Add Integration from the workspace Integrations page to connect Hawzu with an external tool.

Choose a Tool

Select Add Integration to open the add window. Use search to find a tool, then select it.

Hawzu currently supports:

Jira
GitHub Issues
GitLab Issues
Azure DevOps
Slack
Linear

Add Integration Details

The first step lets you add optional details:

Integration Name
Description
Project Scope

Project scope can be All Projects or Selected Projects. If you choose selected projects, pick the projects where the integration should be available.

Enter Credentials

The next step shows the credentials required by the selected tool. Examples include:

Jira site URL, email address, and API token
GitHub personal access token
GitLab instance URL and personal access token
Azure DevOps organization URL and personal access token
Slack bot token
Linear API key

Follow the on-screen instructions for the selected tool.

Test Connection

Use Test Connection after entering credentials. Hawzu shows whether the connection succeeded or failed.

If the connection fails, review the credentials, token permissions, and URL values before trying again.

Configure Tool-Specific Settings

Some integrations need additional settings after a successful connection.

Issue-tracking tools ask for default issue creation settings, such as a project, repository, issue type, work item type, team, state, or labels.

Slack asks for a channel and notification preferences.

Save Behavior

Save is available after the connection is successful and required tool-specific settings are complete.

After saving, the integration appears in the Integrations table with its scope, status, and configuration details.