Quickstart

Connect an integration, build a flow on the canvas, run it, and read the result. You do this in a Flikk workspace, which you land in after signing in. The last section builds the same flow with the API.

Connect an integration

Open Integrations in your workspace and pick one, say Slack. Choose Connect and approve the access it asks for. The connection is then live for your organization and available to every flow in the workspace.

Create a flow

Go to Flows and create a new one. It opens in the editor, the canvas where you build the graph.

Add a trigger and a step

Every flow starts with a trigger. Add one. A webhook trigger listens for an event from an outside service and passes the payload into the flow.

Add a second node for the work: an integration node for the integration you connected, such as the Slack send a message action. Draw an edge from the trigger to it. On the second node, map its inputs from the trigger's output instead of typing fixed values.

Run it

Fire the trigger. Send the event the webhook listens for, or use the editor's test run. Open Runs to see which trigger fired, what each node received and returned, and where it stopped if anything failed.

Build the same flow with the API

The canvas and the API create the same flows. This example sends an email through Resend. Register the resend_key credential first (see Connecting); the integration node references it by name.

Authenticate with Authorization: Bearer flk_... and select your organization with the x-org-slug header. A flow body is { name, graph: { nodes, edges } }. An integration node is { slug, ref, args }, where ref is provider:<slug>/<action>. Add a manual trigger and an edge from the trigger to the node:

curl -X POST https://api.flikk.dev/api/flows \
  -H "Authorization: Bearer flk_your_api_key" \
  -H "x-org-slug: your-org" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Send welcome email",
    "graph": {
      "nodes": [
        { "slug": "trigger", "type": "manual" },
        {
          "slug": "email",
          "ref": "provider:resend/send_email",
          "args": {
            "from": "you@example.com",
            "to": "new@example.com",
            "subject": "Welcome",
            "html": "<p>Glad you are here.</p>"
          }
        }
      ],
      "edges": [{ "from": "trigger", "to": "email" }]
    }
  }'