POST
/
hub
/
auth
/
magic

Authorizations

x-rownd-app-key
string
headerrequired

The publishable key of your application credentials. (more details)

x-rownd-app-secret
string
headerrequired

The private secret of your application credentials. (more details)

Body

application/json
purpose
enum<string>

Determines whether this link will identify a user and allow them to sign in automatically or whether it will just act as a simple redirect. An auth link should only be sent to a single user, whereas a shorten link can be sent to many users if desired, since it does not carry an authentication payload.

Available options:
auth,
shorten
verification_type
enum<string>

The means by which this magic link will be verified by the user. When the magic link is visited, the user's email or phone number will be marked as verified depending on verification mode. In practice, you should set this value to 'phone' if you are sending this link to the user via SMS. Likewise, set to 'email' if you are sending the magic link to the user via email.

Available options:
email,
phone
data
object

Data to add to the user's profile. These properties must exist in the Profile Data portion of the Rownd application. If properties such as email, phone, etc identify an existing user, the user will be auto-matched regardless of the user_id value.

redirect_url
string

The absolute URL or relative path to send your user after sign-in. If the URL is relative, it will be appended to your application's default redirect URL as defined in your Rownd application settings. If no default redirect is set, the magic link creation will fail.

user_id
string
default: __default__

Specify a user ID. If the user already exists, include their user ID. Otherwise, use one of '__default__', '__uuid__', or '__objectid__'. These special values tell Rownd to generate an ID in the provided format, or use the application's default user ID format.

expiration
string

A human-readable string representing the duration for which a magic link is valid. Examples of valid values include 1h, 2d, 3w, 1m, etc. May not exceed 30d. Defaults to 30d.

group_to_join
string

The ID of a group which the user will auto-join upon completing sign-in. The group must have an 'open' admission policy.

Response

200 - application/json
link
string

The magic link URL

app_user_id
string

The user ID specified during creation or the resolved user ID if one of the directives was specified (e.g. '__default__')

Retrieve OIDC configurationInsert or update user profile data