// Team & Settings

API Keys

Create and manage API keys for secure programmatic access to demeterrr

2 min read
Updated March 18, 2026
settingsapikeysintegrations

Use API keys to authenticate server-to-server requests to demeterrr endpoints.

01

Open API Key Settings

Go to Settings > API (/settings/api).

You can:

  • Create keys with scoped permissions
  • View key prefixes and usage metrics
  • Delete keys that are no longer needed
02

Create a New API Key

  1. Click Create API Key.
  2. Enter a key name.
  3. Select one or more scopes.
  4. Save and copy the generated key immediately.

Important: The full key is only shown once.

03

Available Scopes

Current scope options include:

  • contacts:read, contacts:write
  • surveys:read, surveys:send
  • sequences:read, sequences:execute
  • responses:read
  • reviews:read, reviews:write
  • webhooks:read, webhooks:write
04

Send Authenticated Requests

Use either header format:

  • X-API-Key: dem_...
  • Authorization: Bearer dem_...
05

Security Best Practices

  • Use one key per environment or integration
  • Grant only required scopes
  • Rotate keys regularly
  • Delete compromised or stale keys immediately
  • Keep keys in a secret manager, not client code
06

Troubleshooting

Invalid key format

The API expects keys starting with dem_.

Unauthorized or inactive key

Confirm the key:

  • Exists in your organization
  • Is active
  • Is not expired

Forbidden on an endpoint

Your key is valid but missing the required scope for that action.

Was this article helpful?

Let us know if you found this article helpful or if you need more information.

Take Control Of Your Reputation. Take Control Of Your Reputation. Take Control Of Your Reputation. Take Control Of Your Reputation.

Join hundreds of businesses already using demeterrr to collect feedback, boost reviews, and grow faster.

Start Your Trial