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

Operation ID:

DeleteOTP

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

Operation ID:

StatusOTP

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

Operation ID:

ResendOTP

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

Operation ID:

SendOTP

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

Operation ID:

VerifyOTP

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