Quickstart

Schedule your first meeting in 5 minutes

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": ["[e-mail]", "[e-mail]"],
    "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 [e-mail] 
     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:

Investor Call (Morning Priority)

curl -X POST https://api.syncline.run/v1/schedule/auto \
  -H "Authorization: Bearer $SYNCLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "attendees": ["[e-mail]"],
    "duration_minutes": 45,
    "title": "Series A Discussion",
    "context": "investor_call",
    "auto": true
  }'

curl -X POST https://api.syncline.run/v1/schedule/auto \
  -H "Authorization: Bearer $SYNCLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "attendees": ["[e-mail]"],
    "duration_minutes": 15,
    "title": "Quick Sync",
    "context": "team_standup",
    "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