Connect OAuth Providers

Understanding OAuth and why it's needed

Connect OAuth so Recal can securely access users' calendars on their behalf. OAuth lets Recal request permission to read or write calendar data without ever handling user passwords.

OAuth is an industry-standard authorization protocol. Recal uses it to:

• Read calendars to power availability and scheduling
• Create/update events for bookings and workflows
• Limit access to only the scopes you approve

You will create an app in your provider's console (Google Cloud or Microsoft Azure), obtain a Client ID and Client Secret, then add them to Recal.

Scope Management

Recal simplifies OAuth by offering two easy-to-understand scope options:

• edit - Full calendar access for creating, updating, and deleting events
• free-busy - Read-only access to availability information

When you make API calls, Recal automatically validates that users have the correct scopes for each operation. If insufficient, the API returns detailed error messages indicating which scopes are needed. See the provider-specific guides below for detailed scope configuration.