Apps & API Tokens

All API requests require authentication via a Bearer token. Tokens are created inside Apps in the Informly dashboard.

Apps

An App represents an integration or service that connects to Informly. Each app can have multiple API tokens with different permissions and expiry dates.

Creating an app

Log in to the Informly Dashboard
Navigate to Settings > Apps
Click Create App and give it a name and optional description

API Tokens

Tokens are generated inside an app and sent with every API request in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Generating a token

Open your app in Settings > Apps
Click Generate Token
Select the permission scopes your integration needs
Set an expiry date
Copy the token immediately

Token security

API tokens are shown only once when created. Store them securely — you cannot retrieve a token after closing the creation dialog.

Permission scopes

Each token has scoped permissions that control what it can access. Scopes follow the entity:action pattern. When creating a token, select only the permissions your integration needs.

Scopes follow the pattern module:action. The available actions are:

Action	Description
`read`	List and retrieve records
`write`	Create and update records
`delete`	Delete records

Some modules have additional actions specific to their functionality (e.g. coupons:validate).

These actions are available across each module — Contacts, Surveys, Coupons, Referrals, Testimonials, and Tickets. When creating a token, select only the module and action combinations your integration needs.

Coming soon

Currently only the Contacts module is available via the API. Other modules (Surveys, Coupons, Referrals, Testimonials, Tickets) are coming soon.

Token expiry

All tokens have an expiry date set at creation. Once expired, the token is automatically rejected with a 401 error. There is no way to extend a token — generate a new one when needed.