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
Email 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?

  1. Sign up/Login to your tyntec account
  2. Click on API settings
  3. In the API settings, click on New API KEY
  4. 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