Get started in three steps
Register your first custom action with the Flowent API Gateway and start extending Flowent’s capabilities.
Step 1: Create API Credentials
- 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.
- 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"
}'
{
"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
Register an action with your webhook endpoint:
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"]
}
}'
Next steps
