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

{
  "success": true,
  "message": "Meeting scheduled successfully with AI-selected optimal time",
  "chosen_slot": {
    "start_time": "2024-01-15T14:00:00Z",
    "end_time": "2024-01-15T14:30:00Z",
    "score": 0.92
  },
  "agent_reasoning": {
    "why_chosen": "High energy time for both attendees, no adjacent meetings, fair timezone",
    "confidence": 0.95
  },
  "meeting": {
    "id": "mtg_abc123",
    "title": "Product Demo",
    "start_time": "2024-01-15T14:00:00Z",
    "duration_minutes": 30,
    "attendees": ["alice@example.com", "bob@example.com"],
    "status": "confirmed"
  }
}

​
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

Meeting Contexts

Learn how context affects scheduling

MCP Server Guide

Full MCP server documentation

Examples

See real-world implementations