Back to Help Center

API Keys

6 min read

What are API Keys?

API keys are secure credentials that allow external applications and services to interact with your Reminder Flow account programmatically. They enable automation beyond the web interface.

Creating an API Key

  1. Log in to Reminder Flow
  2. Click your profile → Organization Settings
  3. Go to "API & Integrations" → "API Keys"
  4. Click "Generate New Key"
  5. Enter a descriptive name (e.g., "Production API")
  6. Select permissions you want to grant
  7. Click "Create"
  8. Important: Copy the key immediately. You won't be able to view it again for security reasons.

API Key Permissions

When creating an API key, you can choose specific permissions:

  • Events: Create, read, update, delete events
  • Attendees: Manage attendee lists and data
  • Email: Send emails and manage email templates
  • Analytics: Read event and email analytics
  • Settings: Modify organization settings

Best Practice: Only grant permissions that are strictly necessary for your use case (principle of least privilege).

Using Your API Key

Include your API key in the Authorization header of HTTP requests:

Authorization: Bearer YOUR_API_KEY

Example using curl:

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.reminderflow.app/events

Rotating API Keys

Periodically rotate your API keys to maintain security:

  1. Create a new API key with the same permissions
  2. Update your applications to use the new key
  3. Test to ensure everything works
  4. Return to API Keys settings and delete the old key

Security Best Practices

  • Never share your keys: Treat API keys like passwords
  • Use environment variables: Store keys in .env files, not in code
  • Rotate regularly: Change keys every 90 days
  • Use minimal permissions: Only enable what you need
  • Monitor usage: Check API logs for unusual activity
  • Revoke immediately: If you suspect a key is compromised, delete it right away

⚠️ Security Alert

If you accidentally commit an API key to version control, regenerate it immediately. Keys exposed in public repositories are automatically revoked by our security system.

Need Help?

Check out our API documentation or contact support if you have questions about API key management.