Credentials Setup
Connect n8n to your Formfex account using an API key
Overview
The Formfex n8n node authenticates using a Formfex API key. The key is sent as a Bearer token in the Authorization header on every request.
Create an API Key
Log in to Formfex
Go to formfex.com and log in to your account.
Navigate to API Keys
Go to Account > Integrations > API Keys.
Create a new key
Click Create API Key. Give it a name (e.g. "n8n Automation") and select the scopes you need.
Copy the key
Copy the full API key. It starts with fxk_live_ and is only shown once.
Add Credentials in n8n
Open Credentials
In n8n, go to Credentials and click Add Credential.
Search for Formfex
Search for Formfex API and select it.
Paste your key
Paste the API key you copied from Formfex. Click Save.
Test the connection
n8n automatically tests the connection by calling the /api/v1/public/me endpoint. A green checkmark confirms the key is valid.
API Key Format
Formfex API keys follow this format:
fxk_live_<12-char-keyId>.<64-char-secret>
Example: fxk_live_a1b2c3d4e5f6.0123456789abcdef...
The credential validates the key format before making API calls. If you see a format error, make sure you copied the entire key including the fxk_live_ prefix.
Required Scopes
Select the scopes based on the operations you plan to use:
| Scope | Required For |
|---|---|
FORMS_READ | List forms, get form details |
FORMS_WRITE | Create, update, delete, publish/unpublish forms |
RESPONSES_READ | List responses, get response details, trigger node |
AI_GENERATE | AI form generation, job status polling |
ANALYTICS_READ | Smart Analytics, Analytics Chat |
WEBHOOKS_READ | List webhook endpoints |
WEBHOOKS_WRITE | Create, update, delete webhook endpoints |
Least privilege
Only grant the scopes your workflow needs. For example, a workflow that only reads responses needs FORMS_READ and RESPONSES_READ — no write scopes.
API Key Limits by Plan
| Plan | Max API Keys |
|---|---|
| Starter | 2 |
| Pro | 5 |
| Max | 10 |
Rate Limits
Each API key has its own rate limit based on your plan:
| Plan | Per Minute | Per Hour | Per Month |
|---|---|---|---|
| Starter | 20 | 200 | 2,000 |
| Pro | 60 | 1,000 | 20,000 |
| Max | 150 | 3,000 | 200,000 |
When the rate limit is exceeded, the API returns 429 Too Many Requests with a Retry-After header.
Security
The API URL is hardcoded to https://api.formfex.com and cannot be changed. This prevents SSRF attacks on shared n8n deployments.