Back to developer portal

Getting Started

Learn how to authenticate and make your first API call to Revuloop in just a few minutes.

Prerequisites

  • A Revuloop account with an active paid subscription (STARTER or above)
  • Admin or Owner role in your organization
  • Familiarity with REST APIs and JSON
1

Create an API Key

API keys are used to authenticate your requests. Each key has specific scopes that determine what resources it can access.

  1. Navigate to Organization Settings → API Keys
  2. Click "Create API Key"
  3. Give your key a descriptive name
  4. Select the scopes your application needs
  5. Click "Create" and copy your key

Important: Your API key will only be shown once. Store it securely and never expose it in client-side code.

2

Make Your First Request

The API uses Bearer token authentication. Include your API key in the Authorization header of every request.

cURL

curl -X GET "https://revuloop.com/api/v1/surveys" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

JavaScript (fetch)

const response = await fetch('https://revuloop.com/api/v1/surveys', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Python

import requests

response = requests.get(
    'https://revuloop.com/api/v1/surveys',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    }
)

data = response.json()
print(data)
3

Explore the API

All responses follow a consistent envelope format with data, meta, and optional pagination fields. Errors return structured JSON with error codes and messages.

View Full API Reference

The API Reference includes interactive examples, complete request and response schemas, error formats, and all available scopes.

Next Steps