Quickstart

Get started in three steps

Step 1: Create API Credentials

Get your API token

Log into your Flowent admin panel
Navigate to Gateway Management → API Tokens
Click Create New Token and give it a descriptive name
Copy the token and store it securely (you won’t be able to see it again)

Treat API tokens like passwords. Store them in environment variables, never in code.

Create HMAC key

In Gateway Management, go to HMAC Keys
Click Create New Key
Copy the key and store it securely on your server

You’ll use this key to validate webhook signatures from Flowent.

Step 2: Exchange Token for JWT

Before making API calls, exchange your API token for a JWT token:

curl -X POST https://your-flowent-instance.com/api/v1/gateway/token/exchange \
  -H "Content-Type: application/json" \
  -d '{
    "api_token": "your-api-token-here"
  }'

Response:

{
  "jwt_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 86400
}

JWT tokens expire after 24 hours. Exchange your API token again when needed.

Step 3: Register Your First Action

curl -X POST https://your-flowent-instance.com/api/v1/gateway/actions \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "send_email",
    "description": "Send an email to a specified recipient",
    "webhook_url": "https://your-server.com/actions/send_email",
    "json_schema": {
      "type": "object",
      "properties": {
        "recipient": {
          "type": "string",
          "description": "Email address of the recipient"
        },
        "subject": {
          "type": "string",
          "description": "Email subject line"
        },
        "body": {
          "type": "string",
          "description": "Email body content"
        }
      },
      "required": ["recipient", "subject", "body"]
    }
  }'

That’s it! Flowent will validate your webhook endpoint and your action is ready to use.

Getting Started

Guides

API Reference

Get started in three steps

Step 1: Create API Credentials

Step 2: Exchange Token for JWT

Step 3: Register Your First Action

Next steps

API Concepts

API Reference

​Get started in three steps

​Step 1: Create API Credentials

​Step 2: Exchange Token for JWT

​Step 3: Register Your First Action

​Next steps

API Concepts

API Reference

Get started in three steps

Step 1: Create API Credentials

Step 2: Exchange Token for JWT

Step 3: Register Your First Action

Next steps