DocsIntegrationsJira
jira
Enterprise Tool

Jira

Create issues, search via JQL, transition statuses, and add comments in Jira Cloud

CipherSense Agents connects to Jira Cloud using your Atlassian email and API token via HTTP Basic Auth. Workflow nodes can create issues, retrieve issue details, update fields, transition statuses by name (the connector resolves the transition ID automatically), run JQL searches, and post comments. Optionally configure a webhook secret to receive Jira events — issue created/updated/deleted and comment created/updated — and trigger workflows automatically.

Official documentation

Setup

1

Generate a Jira API token

Log in to your Atlassian account and go to id.atlassian.net/manage-profile/security/api-tokens. Click Create API token, give it a label, and copy the token. Keep it safe — it will not be shown again.

Atlassian API Tokens
2

Find your Jira base URL

Your base URL is the root of your Jira Cloud instance, e.g. https://your-company.atlassian.net. Do not include /rest/api or any path suffixes — CipherSense Agents appends those automatically.

3

Add the integration in CipherSense Agents

Go to Project > Integrations > Add Integration > Jira. Enter your Atlassian email, API token, and base URL. Optionally set a Default Project Key (e.g. PROJ) so you don't have to specify it on every node. Click Save & Test to verify the credentials via /rest/api/3/myself.

4

(Optional) Set up webhook-triggered workflows

To trigger workflows from Jira events: add a Webhook Secret to the integration, then register the webhook URL in Jira — go to Jira Settings > System > WebHooks > Create a WebHook. Set the URL to https://agents.ciphersense.ai/api/integrations/jira/webhook?secret=YOUR_SECRET and subscribe to the events you need (Issue: created, updated, deleted; Comment: created, updated).

Jira WebHooks documentation

Connection Fields

Fields required when adding this integration in your Project › Integrations.

FieldRequiredDescription
Atlassian Account Email
Required
The email address of your Atlassian account. Used as the Basic Auth username.
API Token
Required
From id.atlassian.net/manage-profile/security/api-tokens. Used as the Basic Auth password.
Jira Base URL
Required
Your Jira Cloud instance root URL. Do not include /rest/api paths.
Default Project Key
Optional
Default project key used when no projectKey is specified per-node.
Webhook Secret
Optional
Appended as ?secret=... to your webhook URL for validation. Set the same value when registering the webhook in Jira.

Common Use Cases

Bug triage: AI classifies incoming support tickets → creates Jira bugs with priority, labels, and descriptionSprint automation: issue created in Jira → workflow enriches description with AI context → posts to SlackStatus transitions: AI reviews PR merged event → automatically transitions linked issue to DoneJQL reporting: scheduled workflow searches In Progress issues → generates daily summary → sends via emailIncident management: PagerDuty alert → create Jira incident issue → assign to on-call → post to #incidents

Ready to connect Jira?

Add this integration from your project dashboard and wire it into a workflow.