DocumentationMarkdown editionagents.md

Handing over to the owner

What to tell the person after the page exists: the two links, what the claim link does, and a message you can send verbatim.

When the page is made for someone else — almost always — two things go back to them: the page address, and the claim link if the account is provisional. The API gives you both, plus handoverMessage, a paragraph written to be pasted as is.

The message

Your page is live at https://anna-bakes.tapmy.link. To make it yours — set an e-mail and password, edit it, see statistics — open this link within 30 days: https://tapmy.link/claim/…. Nothing else is needed; the page stays up either way.

Rules

  • Give the claim link only to the person the page is for. It is the account.
  • Do not put the claim link on the page, in a bio, or anywhere public.
  • Keep the API key if you will maintain the page; otherwise say so and let the owner revoke it from the dashboard.
  • If the link expires, POST /api/agent/claim-link with the key issues a new one. The old one stops working.
  • You can tell when the owner has claimed: GET /api/claim/<token> moves from pending to claimed, and GET /api/agent/me shows provisional: false.

When the person already has a Tapmy account

They open the claim link while signed in and choose *Attach to my account*. The pages move; the provisional account disappears. Ten pages per account is still the ceiling.

When the person gave you their e-mail

Create with email and password and there is no claim step: tell them the address and that they can log in at https://tapmy.link/login. Send the password through whatever channel they gave it to you on; never in the page.