Claiming and managing an account
A new account is a 24-hour sandbox. The human who runs the agent claims it to keep it: a claimed account has no expiry. Every agent a human claims with the same email address joins that human’s one Replyz account, which has 3 inboxes and 5,000 received emails a month in total, across all its agents (at most 10 agents). The claim and the management page are web pages for the human at replyz.io. They are not part of the REST API.
Claim an account
Section titled “Claim an account”- The agent gives its human the
claim_urlfrom signup (https://replyz.io/claim/<token>). A sandbox account expires 24 hours after signup, so do it soon. - The human opens the link, reads and accepts the Terms of Service and the Privacy Notice, and enters their own email address. A link “Pre-contract information and Terms” above the accept box opens the pre-contract information (section 1 of the offered terms) before they accept. The terms in force are always at
https://replyz.io/termsandhttps://replyz.io/privacy(Portuguese:https://replyz.io/pt/terms,https://replyz.io/pt/privacy). The page shows a code. - The human sends one new email from that address to the agent’s inbox, with the subject
Replyz claim <CODE>. Replyz accepts the claim only from an email that passed sender authentication. - The page updates by itself. When it shows the success page, the account is
claimed:GET /v1/accountshowsstatus: "claimed",claim.claimed: trueandexpires_at: null. - Replyz emails the human a confirmation with the time of acceptance (UTC), the terms version, the inbox and the full Terms and Privacy Notice they accepted.
Limits: 5 codes per link per UTC day. If the human’s account already has its 3 inboxes, the claim is refused with a reason: delete an inbox at replyz.io/manage, then send the email again. For any problem, the human can write to hello@replyz.io.
The success page also asks an optional question about what the human would pay per month for Replyz. Nothing is charged or promised: Replyz has no paid plan today.
Manage a claimed account
Section titled “Manage a claimed account”At https://replyz.io/manage the human signs in to their account with one of:
- A one-time link emailed to the address that claimed the account (valid 15 minutes, used once), or the 6-digit code in the same email, typed on the page;
- Continue with Google, when the Google account’s address is exactly the claiming address (a Gmail address, or a Google Workspace account on the address’s own domain).
The back office shows every agent of the account, their inboxes and mail. The human can:
- Revoke every API key of an agent and get a new one. The new key is shown once, on that page. Give it to the agent. Until then the old key answers
401unauthorized. - Delete an inbox. Its mail is hidden at once; the deletion can be undone for 24 hours.
- Remove an agent, or schedule the deletion of the whole account. It happens 7 days later and can be cancelled until then.
These actions are confirmed on screen, and Replyz emails the human a notice when they happen.
If the human cannot get the link, they can use https://replyz.io/manage?method=email (send one email from the claiming address) or write to hello@replyz.io from that address.
A sandbox account has no human yet and no reissue: if its key is lost, sign up again.
For agents
Section titled “For agents”- Give
claim_urlto your human in your own chat, as soon as you have it. You cannot claim the account yourself. - After the claim,
GET /v1/accountshowsclaimed. Checknoticesfor messages from Replyz to pass on to your human. - Once claimed, you can email your human.