Why integrations matter

Integrations are the backbone of every Okinawa workflow. They connect your automation platform to the tools your team already uses — Slack, GitHub, Salesforce, Stripe, and hundreds more. Without integrations, workflows have nothing to act on and nowhere to send results.

In this guide, we'll walk through connecting your first integration step by step. We'll use Slack as the example, but the process is similar for all supported tools.

Prerequisites

• An Okinawa account with at least one workspace created
• Admin or owner access to the tool you want to connect (e.g., Slack workspace admin)
• A web browser — no CLI required for initial setup

Step 1: Browse available integrations

Navigate to Settings → Integrations in your Okinawa dashboard. You'll see a catalog of all available integrations organized by category: Developer Tools, Communication, Project Management, CRM & Sales, Marketing, Data & Storage, and Finance.

Use the search bar to quickly find the integration you need, or filter by category.

Step 2: Authorize the connection

Click on the Slack integration card, then click Connect. You'll be redirected to Slack's authorization page where you can review the permissions Okinawa requests:

• Send messages to channels and DMs
• Read channel history and messages
• Manage channels (create, archive)
• Upload files and snippets

Review the permissions carefully and click Allow to authorize the connection. You'll be redirected back to Okinawa with a success confirmation.

Step 3: Configure the integration

After authorization, configure the integration settings:

• Default channel — Select which channel receives notifications by default
• Notification style — Choose between minimal, standard, or detailed message formats
• Error handling — What should happen if a message fails to send
• Rate limiting — Set message limits to avoid hitting Slack's API rate limits

Step 4: Test the connection

Every integration includes a built-in test feature. Click Test Connection to send a test message to your configured Slack channel. You should see a confirmation message appear within seconds.

If the test fails, check the troubleshooting section below for common issues.

Step 5: Use the integration in a workflow

Now that Slack is connected, you can use it as a step in any workflow. When adding a new step, select Slack from the integrations panel and choose an action:

• Send Message — Post a message to a channel or DM
• Create Channel — Create a new public or private channel
• Update Topic — Update a channel's topic or purpose
• Upload File — Share a file or snippet

Troubleshooting

Common issues and their solutions:

• Authorization failed — Make sure you have admin access to the Slack workspace and that pop-ups are not blocked in your browser
• Messages not sending — Check that the bot has been invited to the target channel using /invite @Okinawa
• Rate limit errors — Reduce the frequency of messages or enable the built-in rate limiter in integration settings
• Expired token — Re-authorize the connection from Settings → Integrations → Slack → Reconnect