Skip to content
Conductor

Integrations

Integrations connect workflows to external services.

GitHub

Interact with GitHub repositories:

steps:
  - id: create_issue
    github:
      action: create_issue
      repository: owner/repo
      title: "Bug Report"
      body: ${steps.analyze.output}
      labels:
        - bug
        - automated
      token: ${GITHUB_TOKEN}

GitHub Actions

  • create_issue - Create an issue
  • comment_on_pr - Comment on pull request
  • create_pr - Create pull request
  • get_pr - Get PR details
  • list_issues - List repository issues

Slack

Send messages to Slack:

steps:
  - id: notify
    slack:
      action: send_message
      channel: "#alerts"
      text: ${steps.summary.output}
      token: ${SLACK_TOKEN}

Slack Actions

  • send_message - Post message to channel
  • send_dm - Send direct message
  • upload_file - Upload file to channel
  • list_channels - Get channel list

Jira

Manage Jira tickets:

steps:
  - id: create_ticket
    jira:
      action: create_issue
      project: PROJ
      issue_type: Task
      summary: ${steps.generate.output}
      description: "Automated task creation"
      credentials:
        url: https://company.atlassian.net
        email: ${JIRA_EMAIL}
        token: ${JIRA_TOKEN}

Jira Actions

  • create_issue - Create ticket
  • update_issue - Update ticket
  • add_comment - Comment on ticket
  • transition - Move ticket status
  • search - JQL search

Discord

Post to Discord channels:

steps:
  - id: announce
    discord:
      action: send_message
      webhook_url: ${DISCORD_WEBHOOK}
      content: ${steps.announcement.output}
      embeds:
        - title: "Weekly Update"
          description: ${steps.summary.output}
          color: 5814783

Discord Actions

  • send_message - Post to channel
  • send_embed - Rich embedded message
  • upload_file - Attach file

Notion

Create and update Notion pages and database items:

integrations:
  notion:
    from: integrations/notion


steps:
  - id: save_item
    type: integration
    integration: notion.create_database_item
    inputs:
      database_id: "{{.inputs.database_id}}"
      properties:
        Name:
          title:
            - text:
                content: "{{.steps.generate.response}}"
        Status:
          select:
            name: "New"

Notion Actions

  • create_page - Create a new page under a parent
  • get_page - Retrieve page properties
  • update_page - Update page title, icon, or cover
  • upsert_page - Update if exists by title, create if not
  • append_blocks - Add content blocks to a page
  • query_database - Query with filters and sorts
  • create_database_item - Add item to a database
  • update_database_item - Update database item properties

Authentication

All integrations require credentials. Configure them using conductor integrations add:

Terminal window
conductor integrations add notion --token "secret_..."
conductor integrations add github --token "ghp_..."
conductor integrations add slack --token "xoxb-..."

Then declare and use the integration in your workflow:

integrations:
  notion:
    from: integrations/notion


steps:
  - id: save
    type: integration
    integration: notion.create_page
    inputs:
      # ...

Never hardcode tokens in workflow files.

Rate Limits

Each service has rate limits:

  • GitHub: 5000 requests/hour (authenticated)
  • Slack: Tier-based limits (typically 1 req/sec)
  • Jira: Cloud plans vary (10-25 req/sec)
  • Discord: 50 requests/sec per webhook
  • Notion: 3 requests/sec

Conductor does not automatically handle rate limiting. Add delays or implement retry logic if needed.