RecalQuick Start
Integrate calendar functionality in 5 minutes with Recal's Node.js SDK.
For direct API calls without the SDK, check out the interactive API reference.
Setup
1. Get Your API Key
Sign up → Dashboard → API Keys → Create new key
2. Configure OAuth
Dashboard → OAuth Credentials → Add your provider credentials
Need OAuth credentials?
3. Install SDK
npm install recal-sdk
# or: bun add recal-sdk / yarn add recal-sdk4. Initialize
import { RecalClient } from 'recal-sdk'
const recal = new RecalClient({
token: "YOUR_API_KEY"
})
// Test connection
const orgs = await recal.organizations.listAll()First Integration
Create a User
const user = await recal.users.create('user_123')Connect Calendar
// Generate OAuth link
const { url } = await recal.oauth.getLink('user_123', 'google')
// Redirect user to `url` → they authorize → callback with code and state
// Verify connection
await recal.oauth.verify(
'google',
code, // from callback
scope, // from callback
state // from callback
)Read Events
const events = await recal.calendar.getEvents(
'user_123',
new Date('2024-01-01'),
new Date('2024-01-31')
)Next Steps
JS SDK Docs
Complete SDK reference
REST API Reference
All endpoints & schemas
Core Concepts
Data model explained
Need help? Email team@recal.dev