Your Metorial API key authenticates your application with the Metorial platform and gives you access to 600+ integrations.

Creating Your API Key

1. Log in to Metorial: Visit metorial.com and sign in to your account
2. Navigate to Settings: Click on your profile icon and select "API Keys" or "Settings"
3. Generate New Key: Click "Create API Key" or "Generate New Key"
4. Name Your Key: Give it a descriptive name (e.g., "Production App" or "Development")
5. Copy and Save: Copy the key immediately - it won't be shown again!

Storing Your API Key Securely

Never commit API keys to version control. Instead, use environment variables:

Using .env Files

Create a .env file in your project root:

METORIAL_API_KEY=your_api_key_here

Add .env to your .gitignore:

.env

Load it in your code:

import { Metorial } from '@metorial/sdk';

let metorial = new Metorial({ 
  apiKey: process.env.METORIAL_API_KEY 
});

Production Environments

For production deployments:

• Vercel: Add environment variables in Project Settings
• AWS: Use AWS Secrets Manager or Parameter Store
• Docker: Pass as environment variables in your container config
• Kubernetes: Use Kubernetes Secrets

Key Management Best Practices

• Rotate Keys Regularly: Generate new keys periodically
• Use Different Keys: Separate keys for development, staging, and production
• Revoke Compromised Keys: If a key is exposed, revoke it immediately from the Metorial dashboard
• Monitor Usage: Check your API usage regularly in the Metorial dashboard

Troubleshooting

"Invalid API Key" Error: Ensure you've copied the full key without extra spaces or characters

"API Key Not Found": The key may have been revoked - generate a new one

"Rate Limit Exceeded": Check your plan limits in the Metorial dashboard