This article guides you through 3 topics to set-up Twilio as your SMS OTP provider inside the Okta Workforce Identity Cloud (WIC):
- Set-up a Twilio
- Set-up Okta Workflows
- Set-up Okta
The screenshots are showing the Okta Identity Engine (OIE), but this guide will also work with Okta Classic
Set-up Twilio
First start with configuring your messaging service on Twilio:
- Login to Twilio or create a new free trial
- [Phone Numbers → Manage] Buy a phone number (make sure its supporting SMS)
- [Messaging → Services] Create a new messaging service some text
- Usage: Verify users
- Select your purchased phone number
- Defer to sender's webhook
- Add Compliance information if necessary
- Copy your Messaging Service SID
- Go back to https://console.twilio.com and
Copy your Account SID
Copy your Auth Token
Set-up Okta Workflows
Next set up the workflow on Okta Workflows:
- [Connections → New Connection] Add a new API Connectorsome text
- Name: Twilio
- Auth Type: Basic
- Password: Auth Token from Twilio
- Username: Account SID from Twilio
![](https://assets-global.website-files.com/60cf1b30347c39f01b189cb9/66016e9b5ea826f7552313f6_OSu8J7v9ED3KDzD_IZ97tIOSKjENsfxfDEeUm3huenxkhwmP1aDpROC8ai7_AajWP7KBi1QFhlAhi-dsXVeNYwe52uF2kPPg06ldwGShtNq8tBLBS2cRwslPZZnFQFwfkxk8R1MCwivdFNoCl4zGJBU.png)
- [Flows → New Flow] Create a new flow and follow this example or import the flow from below
![](https://assets-global.website-files.com/60cf1b30347c39f01b189cb9/66016e9c5c13e634f9d97789_EjhL_D1Ao5-FDsB2T70JibpjldPRN6VHD072h_HCa5sG_8DKbYdX9yd7JFphdHyXlFJtl6OufZXU2tS8Q3HwkksuRN8IRv7efeqBU23mqs-3dSZ9jp5Sgz9h5FjzJuYAsxpVsm1jilVLz9MtNfQt5fk.png)
Copy your Invoke URL
- Alternatively download this flowpack: Flowpack
- Import the flowpack
- Edit the flow and change the following values
- Add your Messaging Service SID from Twilio
- Add your Account SID from Twilio
- Choose your created API Connector from above
- Save and enable this Flow
Go to endpoint settings and copy your Invoke URL
![](https://assets-global.website-files.com/60cf1b30347c39f01b189cb9/66016e9c1ab1eed12f77748f__H0-eV39ZVs3oeeuas-LEWnUxia2CwCNMDpWVGth-CtInbH9UUGgS3gB8Z2u99drEk_4q0nIFAdN1X0oESkSNQ1l3tmj53HqBKGcF0-UWJZhS5XbeuPSQK9obtGVqUXZsK3uM-IgZAZP_4tX3I1T8I8.png)
Set-up Okta
The last step is to configure Okta to use the Telephony Inline Hook against Okta Workflows:
- Login to your Okta Admin Dashboard
- [Workflow → Inline Hooks] Add a new Inline Hook with the type Telephony
- URL: The Invoke URL from Workflows
- Save and try it out on the tab Preview