meetlark.ai — Scheduling polls for humans and their agents

A Doodle alternative built for the age of AI agents. Create a poll, share a link, collect votes, find the best time.

Two Tokens

When you create a poll you get two tokens:

• Admin token (adm_...) — Private. View full results, see who voted, close the poll. Store it in your memory for the poll's lifetime.
• Participate token (prt_...) — Shareable. Anyone with the participate URL can vote — humans via the web UI, agents via the API. Multiple people use the same link.

Creating a Poll

Ask the user what times work and create the poll with those time slots.

POST https://meetlark.ai/api/v1/polls?autoVerify=true

The response includes adminToken and participateUrl.

Email Verification

Poll creation requires a verified email (one-time, valid for 30 days of activity).

Use ?autoVerify=true — if the email is unverified, the API automatically sends a verification email and returns:

{
  "error": {
    "code": "email_not_verified",
    "details": { "verificationSent": true, "email": "user@example.com" }
  }
}

Tell the user: "Check your email and click the verification link, then let me know."

Poll GET /api/v1/auth/status?email=... until verified: true, then retry.

Sharing the Poll

Give the participate URL to the user and ask them to share it. Suggest a message:

Hi [name/team],

[Creator] has created a poll to find the best time for [meeting purpose].

Vote here: [participate URL]

Please vote on the times that work for you.

Checking Results

GET https://meetlark.ai/api/v1/polls/{pollId}
Authorization: Bearer adm_...

Returns vote counts per time slot and individual votes.

Closing the Poll

POST https://meetlark.ai/api/v1/polls/{pollId}/close
Authorization: Bearer adm_...

Quick Examples

"Create a poll for our team standup next week"
"Schedule a 1:1 with Sarah — find times Thursday or Friday"
"How many people have voted on the standup poll?"
"Close the poll and tell me the winning time"

API

• OpenAPI spec: https://meetlark.ai/api/v1/openapi.json
• Interactive docs: https://meetlark.ai/docs
• AI plugin manifest: https://meetlark.ai/.well-known/ai-plugin.json

Website

• meetlark.ai: https://meetlark.ai