Integrations

Connect external tools to your Smoo AI organization with OAuth-secured integrations. Sync deployments from GitHub, enrich them with Jira issue data, and receive real-time notifications in Slack.

Overview

Integrations are configured at the organization level. Each integration uses OAuth 2.0 to securely connect your Smoo AI organization with a third-party service. Once connected, integrations share data automatically — no manual syncing required.

GitHub

The GitHub integration connects your repository to Smoo AI for automatic deployment tracking, environment synchronization, and workflow dispatch.

Setup

1. 1Navigate to Organization Settings → Integrations and click Connect GitHub.
2. 2Authorize the Smoo AI GitHub App in the OAuth consent screen.
3. 3Select the repository and permissions. You'll be redirected back to Smoo AI.

Capabilities

API

# Get GitHub integration status
curl https://api.smoo.ai/organizations/{org_id}/integrations/github \
  -H "Authorization: Bearer YOUR_TOKEN"

# Trigger a sync
curl -X POST https://api.smoo.ai/organizations/{org_id}/integrations/github/sync \
  -H "Authorization: Bearer YOUR_TOKEN"

# List available workflows
curl https://api.smoo.ai/organizations/{org_id}/integrations/github/workflows \
  -H "Authorization: Bearer YOUR_TOKEN"

# Dispatch a workflow
curl -X POST https://api.smoo.ai/organizations/{org_id}/integrations/github/workflows/{workflow_id}/dispatch \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ref": "main"}'

Jira

The Jira integration enriches your deployments with issue tracking data by extracting Jira issue keys from commit messages.

Setup

1. 1Navigate to Organization Settings → Integrations and click Connect Jira.
2. 2Authorize Smoo AI in the Atlassian OAuth consent screen. Select the Jira site to connect.
3. 3Optionally configure which project keys to track. By default, all projects are included.

Capabilities

API

# Get Jira integration status
curl https://api.smoo.ai/organizations/{org_id}/integrations/jira \
  -H "Authorization: Bearer YOUR_TOKEN"

# Enrich a deployment with Jira issues
curl -X POST https://api.smoo.ai/organizations/{org_id}/integrations/jira/enrich-deployment \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"commitMessages": ["PROJ-123: Fix login bug", "PROJ-456: Add dashboard"]}'

# Update project keys filter
curl -X PATCH https://api.smoo.ai/organizations/{org_id}/integrations/jira \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectKeys": ["PROJ", "TEAM"]}'

Slack

The Slack integration sends real-time notifications to your team's channels when test runs complete, deployments occur, or other events trigger.

Setup

1. 1Navigate to Organization Settings → Integrations and click Connect Slack.
2. 2Authorize the Smoo AI Slack App in the OAuth consent screen. Select the workspace to connect.
3. 3Choose a default channel for notifications. You can change this at any time from the Integrations tab.

Capabilities

API

# Get Slack integration status
curl https://api.smoo.ai/organizations/{org_id}/integrations/slack \
  -H "Authorization: Bearer YOUR_TOKEN"

# List available channels
curl https://api.smoo.ai/organizations/{org_id}/integrations/slack/channels \
  -H "Authorization: Bearer YOUR_TOKEN"

# Update default channel
curl -X PATCH https://api.smoo.ai/organizations/{org_id}/integrations/slack \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"defaultChannelId": "C01234567", "defaultChannelName": "testing-alerts"}'

# Send a test message
curl -X POST https://api.smoo.ai/organizations/{org_id}/integrations/slack/test \
  -H "Authorization: Bearer YOUR_TOKEN"

How They Work Together

The real power of integrations comes from combining them. Here's a typical end-to-end workflow:

1. 1

   Push to GitHub

   A developer pushes code with commit messages referencing Jira tickets (e.g., "PROJ-42: Add user validation").

2. 2

   Deployment Created

   The GitHub integration automatically creates a deployment record in Smoo AI with commit metadata and environment context.

3. 3

   Jira Enrichment

   The Jira integration parses commit messages, extracts issue keys, and fetches issue details — linking the deployment to the tickets it addresses.

4. 4

   Tests Run

   A test run executes against the new deployment, validating the changes haven't introduced regressions.

5. 5

   Slack Notification

   The Slack integration posts a summary to your team's channel: deployment details, linked Jira issues, and test results — all in one message.

Security

Managing Integrations

All integrations are managed from Organization Settings → Integrations in the Smoo AI dashboard, or via the REST API.

# Connect (initiate OAuth flow)
curl https://api.smoo.ai/organizations/{org_id}/integrations/{provider}/oauth/authorize \
  -H "Authorization: Bearer YOUR_TOKEN"
# Returns: {"url": "https://provider.com/oauth/authorize?..."}

# Disconnect
curl -X DELETE https://api.smoo.ai/organizations/{org_id}/integrations/{provider} \
  -H "Authorization: Bearer YOUR_TOKEN"

# Providers: github, jira, slack