PinMe Auth API Integration Guide
A reference skill for calling PinMe's Identity Platform auth proxy APIs from a Worker (TypeScript) to create users, verify id_tokens, and query or list users.
Web & APIIntermediate★ 3,746⑂ 277AI score 8/10Last updated: Sep 12, 2026
What it does
- Documents all four PinMe auth proxy endpoints (
create_user,verify_token,user,list_users) with exact URLs, request bodies, and HTTP error tables. - Explains the shared auth contract (
X-API-Keyheader plusproject_namequery), shared TypeScript types (ApiEnvelope<T>,UserInfo), and provides copy-paste fetch wrappers. - Covers frontend Firebase Auth setup from
public_client_config(including the mandatorytenant_id), email/Google sign-in to obtain anid_token, and server-side verification. - Lists common pitfalls: 403 means unverified email (not an expired token), you must follow
next_page_token, and success requiresresp.ok && code === 200.
Who it's for
- Developers building Worker backends deployed with PinMe who need signup/login.
- Anyone new to multi-tenant Firebase Identity Platform who confuses the server API key with the public web API key.
- Teams standardizing auth error handling in TypeScript.
Example uses
- "Add an email/password signup route to my Worker" → generates the
create_usercall plus verification-email messaging. - "Write middleware that validates the incoming id_token" → calls
verify_tokenand branches 403 vs 401 correctly. - "Export every user for an admin dashboard" → produces a paginated loop over
list_usersusingnext_page_token.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/glitternetwork/pinme/HEAD/skills/pinme-auth/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/pinme-auth folder from the GitHub repo glitternetwork/pinme into my ~/.claude/skills/pinme-auth/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/glitternetwork/pinme.git /tmp/pinme && mkdir -p ~/.claude/skills && cp -r /tmp/pinme/skills/pinme-auth ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repo:
git clone https://github.com/glitternetwork/pinme.git - Create the skills folder if needed:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r pinme/skills/pinme-auth ~/.claude/skills/ - Confirm that
~/.claude/skills/pinme-auth/SKILL.mdexists. - Restart Claude Code, open your PinMe project, and ask something like "integrate PinMe auth into this Worker".
- Set the Worker environment variables
API_KEYandPROJECT_NAMEin advance — never exposeAPI_KEYto the browser.
View source on GitHub ↗License: MIT