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:

```json

{

"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