POST /api/v1/users/{userId}/factors/{factorId}/resend

Resends an sms, call, or email factor challenge as part of an enrollment flow

For call and sms factors, Okta enforces a rate limit of one OTP challenge per device every 30 seconds. You can configure your sms and call factors to use a third-party telephony provider. See the Telephony inline hook reference. Okta round-robins between SMS providers with every resend request to help ensure delivery of an SMS and Call OTPs across different carriers.

Note: Resend operations aren't allowed after a factor exceeds the activation rate limit. See Activate a Factor.

Servers

Path parameters

Name Type Required Description
userId String Yes

ID of an existing Okta user

factorId String Yes

ID of an existing user Factor

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Query parameters

Name Type Required Description
templateId String No

ID of an existing custom SMS template. See the SMS Templates API. This parameter is only used by sms Factors.

Request body fields

Name Type Required Description
factorType String No

Type of the Factor

Possible values:

  • "email"
  • "call"
  • "sms"

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.