LogoRecal

Quick Start

Get started with Recal - AI-powered calendar automation for developers

Quick Start Guide

1. Create an Account

Sign up to get started.

2. Connect Your OAuth Providers

  1. Log in to your Recal dashboard
  2. Navigate to "Settings" (Sidebar left bottom) => "OAuth"
  3. Enter your OAuth Client ID and Client Secret and optionally your production redirect URL
  4. Click "Save"

3. Get Your API Key

  1. Navigate to "API Keys" (Sidebar left)
  2. Click "Create New API Key"
  3. Give it a descriptive name (e.g., "Production App")
  4. Copy the API key and store it securely (e.g., in a .env file; not on a napkin of a public coffee shop)

4. Make Your First API Call

Using cURL

curl -X GET 'https://api.recal.ai/v1/calendars' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Using Node.js

import { RecalClient } from '@recal/api-client'

const recal = new RecalClient({
    apiKey: 'YOUR_API_KEY',
})

// List your calendars
const calendars = await recal.calendars.list()
console.log('Your calendars:', calendars)

Key Features

  • Unified Calendar Management: Handle multiple calendar providers through a single API
  • Real-time Updates: Get instant notifications about calendar changes
  • Powerful Querying: Find available slots across multiple calendars
  • Enterprise-Grade Security: OAuth 2.0 and data encryption
  • Developer Friendly: Well-documented API with client libraries

Next Steps

Need Help?