Send email link

Request

Send a magic link by email to a user.

Required permissions: apps:execute, [appId]:execute, auth:execute.

Security

ClientAccessToken

Bodyapplication/jsonrequired

emailstringrequired

Email of the user

Example:"name@example.com"

redirect_uristringrequired

URI that will receive the authorization code. This is the server GET endpoint used to call the token endpoint, and should accept 'code' as a query parameter. This URI must also be configured as an allowed redirect URI in the Transmit Admin Portal.

Example:"https://www.example.com/verify"

create_new_userboolean

Indicates whether to create a new user at the end of the authentication flow if a user is not found for the provided email. If enabled, public signups must also be configured as allowed for the application.

Default:false

Example:false

resourcestring

URI of the resource the request is attempting to access, which is reflected in the audience (aud claim) of the access token. This must be configured as resource for the application.

email_contentobject

Texts, logo and color to render email template with

require_mfaboolean

Require multi factor authentication for this authentication request.

Default:false

Example:true

claimsobject

Used to request additional claims in the ID token, such as roles, permissions, and other user profile data. The structure is per the OIDC Standard. For supported claims and how to request custom claims, see the ID Token Reference.

Example:

{
  "id_token": {
    "roles": null
  }
}

client_attributesobject

Client attributes

org_idstring

Organization ID, used for member login in B2B scenarios

curl -i -X POST \
  https://api.sbx.transmitsecurity.io/cis/v1/auth/links/email \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "name@example.com",
    "redirect_uri": "https://www.example.com/verify",
    "create_new_user": false,
    "resource": "string",
    "email_content": {
      "subject": "string",
      "primaryColor": "#6981FF",
      "base64logo": "string",
      "headerText": "string",
      "bodyText": "string",
      "linkText": "string",
      "infoText": "string",
      "footerText": "If you didn'\''t request this email, you can safely ignore it.",
      "senderName": "string"
    },
    "require_mfa": true,
    "claims": {
      "id_token": {
        "roles": null
      }
    },
    "client_attributes": {
      "user_agent": "string",
      "ip_address": "string"
    },
    "org_id": "string"
  }'

Responses

Bodyapplication/json

messagestringrequired

Example:"Email sent successfully"

Response

{
  "message": "Email sent successfully"
}