POST /api/v1/users/{userId}/lifecycle/activate
Activates a User.
This operation can only be performed on Users with a STAGED
or DEPROVISIONED
status. Activation of a User is an asynchronous operation.
- The User will have the
transitioningToStatus
property with anACTIVE
value during activation to indicate that the user hasn't completed the asynchronous operation. - The User will have an
ACTIVE
status when the activation process completes.
Users who don't have a password must complete the welcome flow by visiting the activation link to complete the transition to ACTIVE
status.
Note: If you want to send a branded User Activation email, change the subdomain of your request to the custom domain that's associated with the brand. For example, change
subdomain.okta.com
tocustom.domain.one
. See Multibrand and custom domains.
Note: If you have Optional Password enabled, visiting the activation link is optional for users who aren't required to enroll a password. See Create user with Optional Password enabled.
Legal disclaimer After a user is added to the Okta directory, they receive an activation email. As part of signing up for this service, you agreed not to use Okta's service/product to spam and/or send unsolicited messages. Please refrain from adding unrelated accounts to the directory as Okta is not responsible for, and disclaims any and all liability associated with, the activation email's content. You, and you alone, bear responsibility for the emails sent to any recipients.
Servers
- https://{yourOktaDomain}
Path parameters
Name | Type | Required | Description |
---|---|---|---|
userId |
String | Yes |
ID of an existing Okta user |
Query parameters
Name | Type | Required | Description |
---|---|---|---|
sendEmail |
Boolean | No |
Sends an activation email to the user if Default value: true |
How to start integrating
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.