Skip to main content

OTPsApi

MethodHTTP requestDescription
contact_verification_authenticate_using_postPOST /api/web/v1/contact/verification/authenticateAuthenticate Contact Verification Challenge
contact_verification_challenge_using_postPOST /api/web/v1/contact/verification/challengeGet Contact Verification Challenge
create_otp_using_postPOST /api/web/v1/otpsCreates and returns an OTP

contact_verification_authenticate_using_post

OTPVerificationAuthenticateResponse contact_verification_authenticate_using_post(otp_verification_authenticate_value)

Authenticate Contact Verification Challenge

Authenticate the contact verification challenge. Caller requires the CONTACTVERIFICATION:ADD permission.

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
otp_verification_authenticate_valueOTPVerificationAuthenticateValue

Return type

OTPVerificationAuthenticateResponse

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-
400Bad request-
401Authorization information is missing or invalid-
429Too many requests-

contact_verification_challenge_using_post

OTPVerificationChallengeResponse contact_verification_challenge_using_post(otp_verification_challenge_value)

Get Contact Verification Challenge

Get a contact verification challenge for the specified contact. Caller requires the CONTACTVERIFICATION:ADD permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
otp_verification_challenge_valueOTPVerificationChallengeValue

Return type

OTPVerificationChallengeResponse

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200OK-
400Bad request-
401Authorization information is missing or invalid-
429Too many requests-

create_otp_using_post

OTP create_otp_using_post(otp_create_parms)

Creates and returns an OTP

Create and return an OTP. Caller requires the OTPS:ADD permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
otp_create_parmsOTPCreateParms

Return type

OTP

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-