Agent Quickstart

Add a wall of love to your site by typing one sentence into your AI agent. The agent either signs you up (new email) or uses your existing API key (returning user), creates a project, configures the widget, fetches the embed snippet, and edits the right file in your codebase.

Install the Skill#

Download the skill file and place it where your agent expects it. For Claude Code that's usually ~/.claude/skills/showtrust/SKILL.md. See the Skill page for other agents.

Download SKILL.md

Run the install prompt#

With the skill installed, open your agent in your project and tell it what you want:

bash

# In Claude Code, Cursor, or any agent with the skill loaded
add a wall of love to my site, masonry indigo,
my email is you@example.com

The agent calls POST /v1/auth/agent-init with your email. Based on the response it takes one of the two paths below.

New user (first time)#

If your email is brand new, the agent receives an active API key immediately and proceeds to install the widget — no waiting. The whole install finishes in ~30 seconds.

The agent will also seed 3 placeholder testimonials so the wall renders something on first load instead of an empty state. They're created as approved manual entries — identical to ones added in the dashboard — so you can edit, pin, or delete them at Project → Testimonials. Replace them with real ones before launching publicly.

Afterwards, check your inbox for a claim your account email. Click the link, set a password, and you're in. Your widget stays live for 3 days unclaimed — after that the project is removed.

Existing user (adding ShowTrust to another site)#

If your email is already registered, the API responds with accountExists: true and does not issue a new key. The agent asks you to paste your existing key:

Open app.showtrust.to → Settings → API.
Copy your Account ID and API key (regenerate if you don't have one).
Paste both back into your agent.
The agent calls GET /v1/me to verify the credentials, lists your existing projects, and asks whether to create a new project or add the widget to one of them.

This keeps things simple and secure: only you, the legitimate account owner, know your API key — so only you can add ShowTrust to another site.

Troubleshooting#

Agent says “account already exists” but you don't remember signing up — check your inbox (and spam) for a previous ShowTrust email. If you signed up via the agent flow before and never claimed, the account may have already been cleaned up after 3 days. Try again in that case (the email will be treated as new).

API key doesn't work (401) — regenerate it from Settings → API and paste the fresh value back to your agent.

Agent reports a 429 rate limit — too many init attempts in the last hour (5 per IP or 3 per email). Wait an hour or sign up manually.

Claim link expired — re-run the install in your agent. Each agent-init call invalidates any previous unclaimed token for that email.