# User import inline Hook : return command has no impact on user import

**URL:** <https://devforum.okta.com/t/user-import-inline-hook-return-command-has-no-impact-on-user-import/34643>\
**Category:** API\
**Tags:** hooks\
**Created:** [December 3, 2025, 12:23am UTC](https://devforum.okta.com/t/user-import-inline-hook-return-command-has-no-impact-on-user-import/34643 "2025-12-03T00:23:47Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![waheedk](https://avatars.discourse-cdn.com/v4/letter/w/eb9ed0/32.png) [@waheedk](https://devforum.okta.com/u/waheedk)\
**Post date:** [December 3, 2025, 12:23am UTC](https://devforum.okta.com/t/user-import-inline-hook-return-command-has-no-impact-on-user-import/34643/1 "2025-12-03T00:23:47Z")

</div>

We are using a User Import Inline Hook on our Workday application to control matching and linking behavior during user imports.  
The application is configured to match users on a custom attribute. When no match is found, Okta correctly sends the CREATE\_USER action to the inline hook.  
Our inline hook flow then performs its own lookup against Okta UD using the employeeID value from data.appuser.profile. If a matching Okta user is found, the hook returns a LINK\_USER command along with the target user ID.  
Example of the exact JSON returned by the inline hook:  
{  
“commands”: [  
{  
“value”: {  
“id”: “00uoiyjjw0FdYoG2A1d7”  
},  
“type”: “com.okta.user.update”  
},  
{  
“value”: {  
“result”: “LINK\_USER”  
},  
“type”: “com.okta.action.update”  
}  
]  
}

Issue:

Even though the hook responds with a valid LINK\_USER command and the correct Okta user ID:  
Okta does not link the imported user to the existing Okta user.  
The user remains in the Import queue as Unmatched, with only the option to “Create New Account.”  
No error is shown in the System Log indicating that the response was invalid or rejected. sys log shows inlinehook request processed successfully

any help in this regard will be greatly appreciated  
thanks

---

<div class="post-metadata">

**Author:** ![andrea](https://sea1.discourse-cdn.com/oktadev/user_avatar/devforum.okta.com/andrea/32/2172_2.png) [@andrea](https://devforum.okta.com/u/andrea)\
**Post date:** [December 15, 2025, 6:36pm UTC](https://devforum.okta.com/t/user-import-inline-hook-return-command-has-no-impact-on-user-import/34643/2 "2025-12-15T18:36:10Z")

</div>

Hmm, your hook response looks well formatted to me.

If you haven’t already, I would recommend creating a support case on the Support Center for further assistance.

---

<div class="post-metadata">

**Author:** ![system](https://global.discourse-cdn.com/oktadev/original/1X/589c4c5f80de422d01f47cee7185a7fb8227835c.png) [@system](https://devforum.okta.com/u/system)\
**Post date:** [January 14, 2026, 6:36pm UTC](https://devforum.okta.com/t/user-import-inline-hook-return-command-has-no-impact-on-user-import/34643/3 "2026-01-14T18:36:52Z")

</div>

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.
