Authentication
The Sentisnap API uses API keys to authenticate requests.
Getting Your API Key
- Log in to your Sentisnap dashboard
- Go to Settings > API Keys
- Click Create API Key
- Give your key a descriptive name
- Select the scopes (permissions) you need
- Copy your key — it will only be shown once!
Using Your API Key
Include your API key in the Authorization header:
curl -X GET "https://public-api.sentisnap.com/v1/surveys"
-H "Authorization: Bearer YOUR_TOKEN_HERE"API Key Format
API keys follow this format:
sk_live_XXXXXX_YYYYYYYYYYYYYYYYYYYYYYYYsk_live_— prefix indicating a production keyXXXXXX— your team identifierYYYY...— unique random string
Scopes
API keys can be created with limited permissions:
| Scope | Description |
|---|---|
surveys:read | Read survey metadata and structure |
responses:read | Read response data |
responses:export | Export responses to CSV/JSON |
analytics:read | Access analytics and insights |
webhooks:read | View webhook subscriptions |
webhooks:write | Create and manage webhooks |
* | Full access (all permissions) |
Security Best Practices
- Never share your API key publicly or commit it to version control
- Use environment variables to store your API key
- Create keys with the minimum required scopes
- Rotate your keys periodically
- Revoke unused keys immediately
