Connect an account

Goal: Link a third-party account so tools can run with that user’s credentials.

Prerequisites

API key — Authentication
Toolkit slug (for example slack) and an auth config for that toolkit in your project

Steps

Confirm an auth config

List auth configs and note the authConfigId for your toolkit. Create one in the dashboard or via the Auth configs API if missing. See Auth configs.

Create a link URL

curl -X POST "https://flowra.dev/api/v1/connected_accounts/link" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "toolkitSlug": "slack",
    "authConfigId": "YOUR_AUTH_CONFIG_ID"
  }'

For a specific end user, also send x-username. See Multi-tenancy.

Complete OAuth

Open the returned URL in a browser, approve access, then return to your app.

List connected accounts

curl -X GET "https://flowra.dev/api/v1/connected_accounts" \
  -H "x-api-key: YOUR_API_KEY"

Confirm the new connection appears with an active status.

Verify

Link endpoint returns a URL
After OAuth, the account appears in the list
A tool execute that needs that toolkit succeeds when you pass the connection

Getting started

Core building blocks

Data and runtime

Integrate and scale

Recipes

Native tools

Contributing

Connect an account

Prerequisites

Steps

Verify

Next

​Prerequisites

​Steps

​Verify

​Next

Prerequisites

Steps

Verify

Next