Authentication

API Key

Many third-party services—Stripe, Twilio, OpenAI, etc.—issue long-lived secret API keys. Helios lets you store those keys securely and attach them to Integration nodes in your workflows.

For Helios Integration nodes, the key is injected automatically in API calls.

POST https://api.stripe.com/v1/customers
Authorization: Bearer {{ connections.stripe_prod.key }}
Content-Type: application/x-www-form-urlencoded

Rotating a key

1. Generate a new key in the provider's dashboard.
2. Open Integrations in Helios and edit your integration. Paste the new key and click Save.
3. Delete the old key in the provider.

Rotating immediately affects new workflow executions; in-flight retries that were already queued will continue with the previous key.

Helios App with OAuth Flow

Many services require an OAuth flow to be completed. Helios has a built-in OAuth app with all the integrations that can be used to authenticate with these services.

When to use the built-in app

• You need to connect common SaaS providers such as GitHub, Slack, Notion, Google Sheets, etc.
• You do not want to manage client IDs, secrets, and refresh logic yourself.
• The default set of scopes requested by Helios is sufficient for your use-case.

Connecting an account

1. Create a new integration in Helios.
2. Select Helios App if it is available
3. A new tab will open in the browser to complete the OAuth flow.
4. Once the flow is complete, you will be redirected back to Helios.
5. The access and refresh tokens are now stored encrypted in Helios' vault and automatically refreshed when they expire.

Once an account is linked you can reuse it across multiple workflows without re-authentication.

Bring your own (BYO) OAuth App

If you want to have more control over the app itself, you can create your own OAuth app.

Why run your own app?

• Custom branding on the consent screen (your logo and company name).
• Lower the number of requested scopes or add beta scopes not yet supported by Helios.

Set-up steps

1. Create an OAuth application at the provider (e.g. GitHub → Developer Settings → OAuth Apps).
2. Note the Client ID and Client Secret.
3. Perform the OAuth flow and note the token.
4. Inside the Helios Dashboard → Integrations page choose BYO App during creation.
5. Select the provider, paste the Client ID, Secret and Access Token, and click Save.
6. From now on, pick My Own App when connecting accounts in the workflow builder.