1. Docs
  2. API Reference
  3. OAuth hosted login: mail a fresh verification link to an unverified address

OAuth hosted login: mail a fresh verification link to an unverified address

POST/oauth/verify-email/resend

The "Send another link" action on the page a hosted sign-in lands on when the password was correct but the address was never verified. Mails a fresh verification link to email in the client's Environment and re-renders the page in its "sent again" state; nothing is granted. Throttled to 3 requests per hour, the Direct API's resend limit.

Request body

application/json

emailstring Required
client_idstring Required
redirect_uristring Required
response_typestring Required
scopestring Required
statestring Required
code_challengestring Required
code_challenge_methodstring Required
noncestring Optional
organizationstring Optional
reasonenum Required

What led to the page: `sign_in` (a correct password for an unverified address) or `sign_up` (a new account). Decides the page's wording after the resend.

one of "sign_in" · "sign_up"

Responses

text/html

string

application/json

  • errorApiErrorBodyDto*

application/json

  • errorApiErrorBodyDto*

Rate limit

3 requests per 1hPer caller: the signed-in user for a bearer token; for an API key, the key and the end user's address when a backend forwards it, otherwise the client address
Request
curl -X POST "https://auth.canopy-io.com/oauth/verify-email/resend" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "string",
    "client_id": "string",
    "redirect_uri": "string",
    "response_type": "string",
    "scope": "string",
    "state": "string",
    "code_challenge": "string",
    "code_challenge_method": "string",
    "nonce": "string",
    "organization": "string",
    "reason": "sign_in"
  }'
Response
Content-Type: text/html

<!doctype html>
<html lang="en">
  <head>…</head>
  <body>
    <!-- The hosted page: its form, any error, and the Environment's branding -->
  </body>
</html>
 Related endpoints Was this page helpful?

Tell us how we can improve this guide.

Canopy