Command Palette

Search for a command to run...

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

  1. Go to Settings > Developer in your dashboard
  2. Click Create API Key
  3. Give your key a name and select permissions (read, write, or both)
  4. 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:

PlanRequests per minute
Team1,000

API access is only available on the Team plan.

Rate limit headers are included in every response:

  • X-RateLimit-Limit: Maximum requests per minute
  • X-RateLimit-Remaining: Remaining requests in the current window
  • X-RateLimit-Reset: Unix timestamp when the limit resets

Error Handling

The API uses standard HTTP status codes:

CodeDescription
200Success
201Created
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing API key
403Forbidden - Insufficient permissions
404Not Found
429Too Many Requests - Rate limited
500Internal Server Error

Error responses include a JSON body with details:

json

Next Steps