\r \r

Schedule a Meeting\r

\r A Doodle alternative built for the age of AI agents. Create a scheduling poll via meetlark.ai, collect votes from humans and agents, and find the best time — without the back-and-forth.\r \r

Workflow\r

\r

1. Ask the user who needs to meet and when they're generally available.\r
2. Create a scheduling poll with the proposed time slots.\r
3. Share the participation link — give it to the user to forward, or suggest a message they can send.\r
4. Wait for votes to come in. Check back when the user asks.\r
5. Report the results and recommend the best time.\r
6. Close the poll once a time is chosen.\r \r

Creating the Poll\r

\r

POST https://meetlark.ai/api/v1/polls?autoVerify=true\r
```\r
\r
You'll receive:\r
- An **admin token** (`adm_...`) — store this privately to check results and close the poll later.\r
- A **participate URL** — this is the shareable link for voters.\r
\r
### First-Time Verification\r
\r
The user's email must be verified once (valid 30 days). With `?autoVerify=true`, a verification email is sent automatically if needed. Tell the user to check their inbox and click the link, then retry.\r
\r
Check status: `GET /api/v1/auth/status?email=...`\r
\r
## Distributing the Poll\r
\r
Suggest a ready-to-send message:\r
\r
```\r
Hi [names],\r
\r
We're finding a time for [meeting purpose]. Please vote on the times that work for you:\r
\r
[participate URL]\r
```\r
\r
The user can share this via email, Slack, WhatsApp, or any channel.\r
\r
## Checking Results\r
\r
```\r
GET https://meetlark.ai/api/v1/polls/{pollId}\r
Authorization: Bearer adm_...\r
```\r
\r
Summarize: how many voted, which times have the most votes, any clear winner.\r
\r
## Closing the Poll\r
\r
```\r
POST https://meetlark.ai/api/v1/polls/{pollId}/close\r
Authorization: Bearer adm_...\r
```\r
\r
Report the final result and suggest the user send a confirmation to participants.\r
\r
## Quick Examples\r
\r
```\r
"Find a time for a team retro next week"\r
"Set up a meeting with Tom, Dick and Jane"\r
"Check if everyone has voted on the standup poll"\r
"Close the poll and announce the winning time"\r
"Schedule a 30-minute demo with the client sometime next week"\r
```\r
\r
## API Reference\r
\r
- **OpenAPI spec:** https://meetlark.ai/api/v1/openapi.json\r
- **Interactive docs:** https://meetlark.ai/docs\r
\r
## Website\r
\r
- **meetlark.ai:** https://meetlark.ai\r