tyntec 2FA (Preview)
Tyntec Authentication is a tool for user-friendly two-factor authentication (2FA) with SMS and voice.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | tyntec support |
| URL | https://www.tyntec.com/get-help-support |
| support@tyntec.com |
| Connector Metadata | |
|---|---|
| Publisher | tyntec GmbH |
| Website | https://www.tyntec.com |
| Privacy policy | https://www.tyntec.com/data-privacy-statement |
| Categories | Security;Commerce |
2FA is user-friendly and feature-rich API that send the passcode to your users phone via the appropriate channel (SMS or voice). Complete with multi-language and customization support.
Pre-requisites
You will need the following to proceed:
- A Microsoft Power Apps or Power Automate plan with custom connector feature
- tyntec API Key
How to get API Key?
- Sign up/Login to your tyntec account
- Click on API settings
- In the API settings, click on New API KEY
- Copy the newly assigned API key
Known Limitation
- In case of unsuccesfull verification (the code is not valid), the returned response is 401, which stops your Flow
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| apikey | securestring | Your tyntec Authentication (2FA) apikey | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Delete One-Time Password |
Deletes a given One-time Password |
| Get One-Time Password Status |
Gets status report for given One-Time Password |
| Resend One-Time Password |
Resends the given OTP (One-time Password) to a destination number. |
| Send One-Time Password |
Sends an OTP (One-time Password) to a destination number. |
| Verify One-Time Password |
Verifies the given OTP code. |
Delete One-Time Password
Deletes a given One-time Password
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
One-time Password ID
|
otpID | True | string |
ID of your OTP |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
applicationId
|
applicationId | string |
applicationId |
|
number
|
number | string |
number |
|
attemptCount
|
attemptCount | integer |
attemptCount |
|
otpStatus
|
otpStatus | string |
otpStatus |
|
expire
|
expire | integer |
expire |
|
created
|
created | integer |
created |
|
referenceId
|
referenceId | string |
referenceId |
|
timestampCreated
|
timestampCreated | string |
timestampCreated |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |
Get One-Time Password Status
Gets status report for given One-Time Password
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
One-time Password ID
|
otpID | True | string |
ID of your OTP |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
applicationId
|
applicationId | string |
applicationId |
|
number
|
number | string |
number |
|
attemptCount
|
attemptCount | integer |
attemptCount |
|
otpStatus
|
otpStatus | string |
otpStatus |
|
expire
|
expire | integer |
expire |
|
created
|
created | integer |
created |
|
referenceId
|
referenceId | string |
referenceId |
|
timestampCreated
|
timestampCreated | string |
timestampCreated |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |
Resend One-Time Password
Resends the given OTP (One-time Password) to a destination number.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
One-time Password ID
|
otpID | True | string |
ID of your OTP |
|
Delivery Channel
|
via | string |
The delivery channel |
|
|
Sender
|
Sender | string |
Sender name for OTP delivery via SMS (if you want to override the application template one) |
|
|
Caller
|
Caller | string |
Caller id for OTP delivery via Voice (if you want to override the application template one) |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
applicationId
|
applicationId | string |
applicationId |
|
number
|
number | string |
number |
|
attemptCount
|
attemptCount | integer |
attemptCount |
|
otpStatus
|
otpStatus | string |
otpStatus |
|
expire
|
expire | integer |
expire |
|
created
|
created | integer |
created |
|
referenceId
|
referenceId | string |
referenceId |
|
timestampCreated
|
timestampCreated | string |
timestampCreated |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |
Send One-Time Password
Sends an OTP (One-time Password) to a destination number.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Phone Number
|
number | True | string |
Receiver's Phone Number |
|
Text
|
text | string |
In case you want to overwrite the application template |
|
|
Pin Lenght
|
pinLength | integer |
Length of the auto generated PIN |
|
|
Delivery Channel
|
via | string |
The delivery channel |
|
|
Application ID
|
applicationId | integer |
The applicationId of the application you would like to use. If not specified, uses default one. |
|
|
Language
|
language | string |
Specifies the local language in ISO 639-1 |
|
|
Country
|
country | string |
The ISO 3166-1 alpha-2 code of the destination number. |
|
|
OTP Code
|
otpCode | string |
The OTP code to be delivered instead of auto generated one. |
|
|
Sender
|
Sender | string |
Sender name for OTP delivery via SMS (if you want to override the application template one) |
|
|
Caller
|
Caller | string |
Caller id for OTP delivery via Voice (if you want to override the application template one) |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
applicationId
|
applicationId | string |
applicationId |
|
number
|
number | string |
number |
|
attemptCount
|
attemptCount | integer |
attemptCount |
|
otpStatus
|
otpStatus | string |
otpStatus |
|
expire
|
expire | integer |
expire |
|
created
|
created | integer |
created |
|
referenceId
|
referenceId | string |
referenceId |
|
timestampCreated
|
timestampCreated | string |
timestampCreated |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |
Verify One-Time Password
Verifies the given OTP code.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
One-time Password ID
|
otpID | True | string |
ID of your OTP |
|
One-Time Password Code
|
otpCode | integer |
Input One-time password code that you want to verify |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
otpId
|
otpId | string |
otpId |
|
accountId
|
accountId | string |
accountId |
|
applicationId
|
applicationId | string |
applicationId |
|
number
|
number | string |
number |
|
attemptCount
|
attemptCount | integer |
attemptCount |
|
otpStatus
|
otpStatus | string |
otpStatus |
|
expire
|
expire | integer |
expire |
|
created
|
created | integer |
created |
|
referenceId
|
referenceId | string |
referenceId |
|
timestampCreated
|
timestampCreated | string |
timestampCreated |
|
timestampExpire
|
timestampExpire | string |
timestampExpire |