Obtaining Your API Key
Prerequisites
Before using the Public API, make sure the following conditions are met:
- You are logged into your account.
- Your account is on the retail_full or fnb_full plan.
- Your user role is Owner or Administrator.
Note: The Public API section is only available under these plans and roles. If your plan or role does not match, the section will not be displayed.
Step-by-Step Instructions
Follow these steps to obtain your first API Key.
1. Navigate to Settings
- Go to Settings in your account.
2. Open the Public API Section
- Find and select the Public API section.
- If you are visiting for the first time, the API keys list will be empty and you will be prompted to create a new key.
3. Create a New API Key
- Click the option to create a new API key.
- The key will be generated in the following format:
fk_live_<64 hexadecimal characters> - Save this key securely. You will need it for the next steps.
4. Proceed to Authentication
- Use the obtained API Key to get a JWT token by following the Public API Authentication guide.
- Endpoint:
POST /api/v1/auth/tokens - Detailed steps are described in the dedicated authentication documentation.
Managing Existing API Keys
In the Public API section, you may also:
- View all created API keys
- Delete an API key — this will immediately invalidate all tokens associated with that key