One-time tokens

Create one-time token

Create a new one-time token associated with an email address. The token can be used for verification purposes and has an expiration time.

post/api/one-time-tokens

Request

  • Base URL: https://[tenant_id].logto.app
  • URL: https://[tenant_id].logto.app/api/one-time-tokens
  • Auth: OAuth 2 (client credentials, token URL /oidc/token, scopes: all)

Request body

emailstring required

The email address to associate with the one-time token.

expiresInnumber

The expiration time in seconds. If not provided, defaults to 10 mins (600 seconds).

Response

The one-time token was created successfully.

tenantIdstring required
idstring required
emailstring required
tokenstring required
status'active' | 'consumed' | 'revoked' | 'expired' required
createdAtnumber required
expiresAtnumber required

Changes

No recorded changes to this operation across all 8 revisions of this API.