Skip to main content

​
Get Your API Key

1

Sign Up

Visit syncline.run/developer/login and authenticate with Google.
2

Copy Your API Key

After authentication, you’ll see your API key on the developer dashboard. Copy it and store it securely.
export SYNCLINE_API_KEY="your_api_key_here"

​
Connect Your Calendar

Before scheduling meetings, you need to connect your Google Calendar:
1

OAuth Flow

On the developer dashboard, click “Connect Calendar” and authenticate with Google.
2

Grant Permissions

Allow Syncline to read your calendar availability and create events.
3

Verify Connection

You’ll see a green checkmark when your calendar is connected.

​
Schedule Your First Meeting

​
Using the REST API

curl -X POST https://api.syncline.run/v1/schedule/auto \
  -H "Authorization: Bearer $SYNCLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "attendees": ["alice@example.com", "bob@example.com"],
    "duration_minutes": 30,
    "title": "Product Demo",
    "context": "client_demo",
    "description": "Demo of our new features",
    "auto": true
  }'

​
Response (202 Accepted)

The API returns immediately with a job ID. Results are delivered via webhook. 
{
  "job_id": "sched_7d8f9e3a2b1c",
  "status": "processing",
  "message": "Scheduling request received. Results will be delivered via webhook.",
  "estimated_completion_seconds": 10,
  "webhook_event": "meeting.scheduling.completed"
}
Async API: The scheduling happens in the background. You’ll receive a meeting.scheduling.completed webhook with the meeting details, or meeting.scheduling.failed if scheduling fails. See Webhooks for details.

​
Using the MCP Server (For AI Agents)

If you’re building with Claude or other AI agents, use our MCP server:

​
Installation

npm install -g @kekwanulabs/syncline-mcp-server

​
Configure Claude Desktop

Add to your claude_desktop_config.json: 
{
  "mcpServers": {
    "syncline": {
      "command": "npx",
      "args": ["-y", "@kekwanulabs/syncline-mcp-server"],
      "env": {
        "SYNCLINE_API_KEY": "your_api_key_here"
      }
    }
  }
}

​
Use with Claude

You: Schedule a 30-minute product demo with alice@example.com 
     next week. Pick the best time automatically.

Claude: I'll use Syncline to find and schedule the optimal time...
        [Uses schedule_auto tool]
        
        Done! I've scheduled your product demo for Tuesday, 
        January 16th at 2:00 PM. Calendar invites sent to both attendees.

​
Understanding Meeting Contexts

Syncline’s AI uses context to make smart scheduling decisions: 
curl -X POST https://api.syncline.run/v1/schedule/auto \
  -H "Authorization: Bearer $SYNCLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "attendees": ["investor@vc.com"],
    "duration_minutes": 45,
    "title": "Series A Discussion",
    "context": "investor_call",
    "auto": true
  }'

​
Available Meeting Contexts

  • warm_intro - Introduction to someone you know
  • cold_outreach - First contact
  • investor_call - Meeting with investors (prioritizes mornings)
  • client_demo - Product demonstration
  • team_standup - Daily team sync (flexible timing)
  • one_on_one - 1:1 meeting
  • interview - Job interview
  • sales_call - Sales conversation
  • strategy_session - Strategic planning
  • brainstorm - Creative ideation
  • review - Performance or project review
  • casual_chat - Informal catch-up
  • urgent - Time-sensitive meeting

​
Next Steps

API Reference

Explore all API endpoints

Smart Ranking

Learn how slots are ranked by quality

MCP Server Guide

Full MCP server documentation

AI Assistant Example

Build a complete scheduling agent