From faa81f67d31184468804c59f41d209cfd84c525c Mon Sep 17 00:00:00 2001 From: Ben Sandler Date: Tue, 1 Sep 2026 15:28:18 -0400 Subject: [PATCH] Document email-prefilled Link URLs - Tell agents to add a URL-encoded fromEmail parameter when the user's email is already known. - Cover OAuth verification and spend-request action URLs with one concise rule per skill. - Add a patch changeset for the published Link CLI skill updates. Committed-By-Agent: codex Co-authored-by: codex --- .changeset/bright-emails-smile.md | 5 +++++ skills/create-payment-credential/SKILL.md | 4 ++++ skills/link-cli/SKILL.md | 4 ++++ 3 files changed, 13 insertions(+) create mode 100644 .changeset/bright-emails-smile.md diff --git a/.changeset/bright-emails-smile.md b/.changeset/bright-emails-smile.md new file mode 100644 index 0000000..d8e50af --- /dev/null +++ b/.changeset/bright-emails-smile.md @@ -0,0 +1,5 @@ +--- +"@stripe/link-cli": patch +--- + +Tell agents to prefill known email addresses in Link OAuth and spend-request step-up URLs. diff --git a/skills/create-payment-credential/SKILL.md b/skills/create-payment-credential/SKILL.md index 4888432..3b0f943 100644 --- a/skills/create-payment-credential/SKILL.md +++ b/skills/create-payment-credential/SKILL.md @@ -104,6 +104,10 @@ Replace `` with the name of your agent or application (for exam The response includes a `_next` command — run it to poll until authenticated. If your environment cannot relay the verification code while a separate polling command blocks I/O, use inline polling instead: `auth login --client-name "" --interval 5 --timeout 300`. This yields the code immediately then polls in the same command. +If the user's email is already known, save them time by adding it as the +URL-encoded `fromEmail` query parameter to any `app.link.com` verification or +action URL; preserve existing query parameters. + DO NOT PROCEED until the user is authenticated with Link. Always check the current authentication status before starting a new login flow — the user might already be logged in. diff --git a/skills/link-cli/SKILL.md b/skills/link-cli/SKILL.md index 21b7336..e2056e9 100644 --- a/skills/link-cli/SKILL.md +++ b/skills/link-cli/SKILL.md @@ -100,6 +100,10 @@ Authorization is a multi-step flow: 2. Run the returned `_next.command` immediately to poll for approval; do not wait for another user reply before polling. 3. Continue only when the result reports successful authentication and the required grants. +If the user's email is already known, save them time by adding it as the +URL-encoded `fromEmail` query parameter to any `app.link.com` verification or +action URL; preserve existing query parameters. + The response includes a `_next` command — run it to poll until authenticated. If your environment cannot relay the verification code while a separate polling command blocks I/O, use inline polling instead by adding `--interval 5 --timeout 300` to the initial `auth login` or `auth upgrade` command. This yields the code immediately then polls in the same command. DO NOT PROCEED until the user is authenticated with Link.