API Introduction
Overview of the Vavolta REST API, authentication, and rate limits.
Overview
The Vavolta API is a REST API that allows you to programmatically manage lead magnets, access links, and retrieve analytics data.
Base URL
All API requests should be made to:
GEThttps://vavolta.com/api/v1
Authentication
All API requests require authentication using an API key. Include your API key in the Authorization header:
cURL CommandN8N Ready
Creating an API Key
- Go to Settings > Developer in your dashboard
- Click Create API Key
- Give your key a name and select permissions (read, write, or both)
- Copy your key - it will only be shown once!
Keep your API key secure. Never expose it in client-side code or public repositories.
Rate Limits
API requests are rate limited:
| Plan | Requests per minute |
|---|---|
| Team | 1,000 |
API access is only available on the Team plan.
Rate limit headers are included in every response:
X-RateLimit-Limit: Maximum requests per minuteX-RateLimit-Remaining: Remaining requests in the current windowX-RateLimit-Reset: Unix timestamp when the limit resets
Error Handling
The API uses standard HTTP status codes:
| Code | Description |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Invalid or missing API key |
| 403 | Forbidden - Insufficient permissions |
| 404 | Not Found |
| 429 | Too Many Requests - Rate limited |
| 500 | Internal Server Error |
Error responses include a JSON body with details:
json
Next Steps
- Authentication - Detailed authentication guide
- Lead Magnets - Manage lead magnets via API
- Webhooks - Set up real-time event notifications