Skip to main content
POST
Find Mutual Availability

Endpoint

Request Body

string[]
required
Array of email addresses. Must be exactly 2 for MVP.
integer
default:30
Meeting duration in minutes. Min: 15, Max: 120.
object
Optional custom date range. Defaults to user’s availability_window_days preference (14 days).
string
Optional meeting context for better title generation.Example: "Introduction call after LinkedIn connection"

Response

TimeSlot[]
Array of 5 time slots, ranked by quality (best first).
integer
Total number of slots found (always 5 or less)
object
Date range searched

Example Request

Example Response

Error Responses

Status: 400 Bad Request
Status: 404 Not FoundSolution: User must complete OAuth flow at syncline.run
Status: 200 OKNote: This is not an error. Try expanding the date range or adjusting preferences.

How Slots Are Ranked

Syncline uses a smart ranking algorithm with 5 factors:
Avoids times outside 8am-6pm for either person.Score impact: 0.5x penalty for awkward hours
10am is the ideal meeting time for most professionals.Score impact: 1.2x boost for 10am slots
People protect Friday afternoons for focus work.Score impact: 0.7x penalty after 2pm on Fridays
Noon-1pm is typically reserved for lunch.Score impact: 0.8x penalty for 12pm-1pm
Sooner is better—momentum matters for intros.Score impact: 1.1x boost for slots within 3 days
Final score = Base (1.0) × All factors Learn more: Smart Ranking Explained

Best Practices

Always use the first slot. It’s ranked highest for a reason. Only offer alternatives if user explicitly requests them.
Cache results for 5 minutes. Availability doesn’t change that fast. Reduces API calls.
Show timezone to user. Even though Syncline handles conversion, transparency builds trust.

Next Steps

Schedule Meeting

Book one of the available slots

Smart Ranking

Deep dive into the ranking algorithm