Connecting

To use an integration, you must connect with it. This page outlines the common ways to do so.

You connect once, on the Integrations page. After that, the integration's actions are available to every flow in your workspace. How you connect depends on the integration: some take an API key, others use OAuth.

API key

Generate a key in the provider's dashboard, then register it with Flikk. Give it the name the integration expects and the key value:

curl -X POST https://api.flikk.dev/api/integrations/credentials \
  -H "Authorization: Bearer flk_your_api_key" \
  -H "x-org-slug: your-org" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "resend_key",
    "value": { "apiKey": "re_..." }
  }'

The response echoes the stored name:

{ "stored": "resend_key" }

Register again with the same name to replace it. In the app, the Integrations page has a form that does the same thing.

OAuth

Some integrations connect through the provider instead of a key. On the Integrations page, choose Connect. Flikk sends you to the provider, you approve, and you land back connected. No key to generate or paste.

OAuth runs in the browser, so connect these from the app. There is no API equivalent yet.

Using a credential

A node names the credentials it needs in config.auth, by the name you registered:

{
  "slug": "welcome",
  "type": "http_request",
  "spec": { "method": "POST", "url": "https://api.resend.com/emails" },
  "config": { "auth": ["resend_key"] }
}

Integration nodes (provider:<slug>/<action>) set config.auth for you. You declare it yourself on http_request and generate nodes.

Replacing a credential

Override a key by registering it again under the same name. The new value replaces the old one, and nodes referencing that name keep working:

curl -X POST https://api.flikk.dev/api/integrations/credentials \
  -H "Authorization: Bearer flk_your_api_key" \
  -H "x-org-slug: your-org" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "resend_key",
    "value": { "apiKey": "re_new_key..." }
  }'

Delete one by name. Flows referencing it fail until you register a replacement:

curl -X DELETE https://api.flikk.dev/api/integrations/credentials/resend_key \
  -H "Authorization: Bearer flk_your_api_key" \
  -H "x-org-slug: your-org"

For OAuth, reconnect from the Integrations page. The new grant replaces the old one under the same name.