BindID Registration Links

BindID allows you to send registration links to users that, when opened, initiate a BindID registration flow. The links are sent via email and are valid for 30 minutes from the time they are sent.

Note: To change this, contact your Transmit representative to enable a preview feature where the expiration time can be set on the Application's settings page in the Admin Portal.

Registration links can be used to promote BindID registration to existing users who are not yet registered in BindID.

Important: To enable user registration via links, you must add redirect URIs on the Applications page in the BindID Admin Portal:

  • For the production environment: https://aux.identity.security/register/activate-account
  • For the EU production environment: https://aux.eu.identity.security/register/activate-account
  • For the sandbox environment: https://aux.bindid-sandbox.io/register/activate-account

To send links, you need to invoke the Send Activation API. The following example sends a link to the someone@example.com email address:

POST /api/v1/mgmt/send-activation HTTP/2
Host: admin.bindid-sandbox.io
Authorization: Bearer k_lONS-upqKzUx_UWpmJBIiybpf2ZyEkmBTcUYkvSEI
Content-Type: application/json
{
"clientId": "3d70edce.23bf0963.tid_7d4bd3fc.bindid.io",
"credentialsId": "55b9e897.management_api_app.tid_7d4bd3fc.bindid.io",
"verifications": [
"ts.bindid.iac.email",
"ts.bindid.iac.phone_number"
],
"userEmail": "someone@example.com",
"scopes": [
"email",
"phone"
],
"alias": {
"type": "none"
},
"customMessage": "Just a few more seconds...",
"secondaryCompletionMessage": "Go back to your desktop to finish registering your device.",
"completionMessage": {
"text": "Welcome to ACME",
"link": {
"redirectUri": "https://www.acme.com",
"label": "Go to our portal"
}
}
}
}

When a user successfully completes the flow, the user is registered to BindID and the user's email address is verified even if email (ts.bindid.iac.email) is not a requested verification.