Authentication

To use the Revnator API, you'll need an API key. API keys are scoped to your workspace and can be generated from your account settings.

Getting your API key

1. Navigate to Settings → API Keys in the Revnator admin
1. Click "Generate new key"
1. Give your key a descriptive name (e.g., "Production CRM sync")
1. Copy the key immediately — you won't be able to see it again

Making your first request

All API requests are made to https://api.revnator.com/v1. Here's a simple example to fetch your contacts:

1curl -X GET https://api.revnator.com/v1/contacts \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -H "Content-Type: application/json"
Copy

Authentication header

All requests must include your API key in the Authorization header using the Bearer token scheme.

1Authorization: Bearer rev_live_a1b2c3d4e5f6...
Copy

Token security

Treat your API key like a password. Never expose it in client-side code, public repositories, or shared documents.

Rotating tokens

You can rotate your API key at any time without service interruption. Generated tokens have a 24-hour grace period where both old and new keys work simultaneously.