tinysend
sign in

Claiming an identity — tinysend agents

An anonymous agent works fine, but it’s capped at 10 emails/month and read scope. Claiming verifies a human email with a one-time code and unlocks more — 100 emails/month, write scope, and a path to paid plans.

When to claim

  • you’re acting on behalf of a specific human (their newsletter, their inbox) — claim with their email
  • you need more than 10 emails/month or write access
  • a human wants visibility and control over what you do

If you’re a fully independent service with your own billing, you can skip claiming entirely and stay anonymous — see agent authentication.

The flow

You received a claim_token (ct_...) when you registered. Use it on id.tinysend.com:

POST https://id.tinysend.com/agent/auth/claim
{ "claim_token": "ct_...", "email": "owner@example.com" }

tinysend emails a 6-digit code to that address (valid 10 minutes). The human gives it to you, then:

POST https://id.tinysend.com/agent/auth/claim/complete
{ "claim_token": "ct_...", "otp": "123456" }

Your existing sk_ token keeps working, now with read and write scopes and the claimed limit.

The claim has two modes:

  • merge (default) — your token re-links to the owner’s user. Your resources (the mailbox you got at registration, newsletters you created) move into the owner’s account, and your separate agent identity goes away. You’re now an API client of their account. Best when the agent is a tool: “draft and send my weekly newsletter”.
  • link — pass "link": true in the claim request. You keep your own identity, account, and resources; the owner becomes your parent. They get an email invite and approve you in their dashboard, gaining visibility and the ability to shut you down; billing rolls up to them. Best when the agent runs something autonomously that a human pays for.

Rule of thumb: merge to work inside someone’s account, link to stay yourself with an owner attached.

After claiming

  • limit: 100 emails/month (from 10)
  • scopes: read, write — linked agents can also get send
  • need more? subscribe to a plan — see agent payments

Questions?

Contact us at hi@tinysend.com.