# Bitbucket

### What is Bitbucket integration in ZigiOps?

Bitbucket is a Git-based source code management platform used for version control, collaboration, and CI/CD workflows.

ZigiOps enables secure, agentless integration between Bitbucket and ITSM, DevOps, and enterprise systems. Using ZigiOps, Bitbucket commits, issues, and repository events can be synchronized with downstream systems to support development-to-operations workflows.

With ZigiOps, Bitbucket can:

* Send commit and issue information to ITSM systems
* Trigger incident or ticket creation based on repository activity
* Support DevOps-to-ITSM workflows
* Integrate without custom scripts or plugins

### Which Bitbucket versions are supported?

Using a supported version is mandatory.

| Product   | Supported Deployment Types | Supported Versions |
| --------- | -------------------------- | ------------------ |
| Bitbucket | All                        | All                |

### Are there any environmental prerequisites for Bitbucket?

{% hint style="info" %}
Confirm the prerequisites of the corresponding integration template before continuing further, as some templates may not require all environmental prerequisites.

See the **Related Templates** section at the end of this page.
{% endhint %}

### How do I connect Bitbucket to ZigiOps?

#### Bitbucket - Connected System Configuration

Follow the steps below to add Bitbucket as a connected system in ZigiOps.

{% stepper %}
{% step %}
Log in to your **ZigiOps** instance.
{% endstep %}

{% step %}
Navigate to **Connected Systems > Add New System > Bitbucket** and configure the following parameters:

**Server URL**\
Input the URL of your Bitbucket instance.\
Example: `https://api.bitbucket.org`

**API Key**\
Input your Bitbucket API key.

**Client Secret**\
Input your Bitbucket client secret.

**Workspace**\
Input your Bitbucket workspace name.

**Proxy Settings (optional)**\
Enable this option if a proxy server is required for outbound communication.
{% endstep %}

{% step %}
Review the configuration.
{% endstep %}

{% step %}
Click **Save** to store the connected system.

Once saved, Bitbucket becomes available for use in ZigiOps integration templates.
{% endstep %}
{% endstepper %}

### What are the most common Bitbucket integration use cases?

#### Use case 1: Creating ITSM incidents from Bitbucket commits

ZigiOps can forward Bitbucket commit information to ITSM systems, allowing teams to automatically create incidents or tickets based on repository activity or commit patterns.

#### Use case 2: Synchronizing Bitbucket issues with ITSM platforms

Bitbucket issues can be synchronized with ITSM systems to ensure visibility between development and operations teams, reducing manual communication and context switching.

#### Use case 3: DevOps-to-ITSM workflow automation

By integrating Bitbucket with ITSM platforms, ZigiOps enables automated workflows that connect code changes with operational processes, improving traceability and incident response.

### What integration templates are available for Bitbucket?

ZigiOps provides prebuilt integration templates for Bitbucket, depending on the target system and use case.

#### Related Templates

* Bitbucket commits - ServiceNow incidents
* Bitbucket issues - ServiceNow incidents

Each template includes:

* Predefined entity mappings
* Direction of synchronization
* Entity-specific logic and filtering rules

Templates are documented individually in the **Integration Catalog**.

### Summary

The Bitbucket integration in ZigiOps provides:

* Secure, agentless integration with Bitbucket repositories
* Support for all Bitbucket versions and deployment types
* API-based authentication using API key and client secret
* Flexible proxy support
* Ready-to-use templates for DevOps and ITSM workflows


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zigiwave.com/available-systems/bitbucket.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.