Thursday, April 25, 2013

Using Web services in SailPoint IIQ

SailPoint has a lot of predefined REST web services which can be used to call specific functions from a web service client.
If you have requirement to execute a task or report without using the Sailpoint UI or console directly, then you can use the web services option, or it can be any general requirement.

Web services can be used in two different ways in Sailpoint.

  • Using IIQclient class
  • Creating custom web service 

Using IIQclient class
  1. Import the identityiq.jar file in eclipse. This jar contains the class sailpoint.integration.IIQClient; which contains the default functions provided by sailpoint to call the web services.
  2. Create a sample class to create a object of iiqclient class to call the functions available publicly 
  3.  Download the  REST API Integration pdf from compass, which has all the functions listed in details.

 Custom Web Service
  1. Creating custom web service as per the needs is the best option to develop the function as per requirements.
  2. Create a custom web service method class which will extend BaseResource class.
  3. BaseResource class will give you the context object of sailpoint to create methods as required.
  4. Create a class which will extend the to include the method create in step3
  5. Go to web.xml and modify the value of to your custom class.
  6. Now you can call the custom webservice using any client which can all REST web services.
  7. The return type of REST web-services is JSON, which needs to be converted to process it properly.



public class CustomWebServiceMethod extends BaseResource{

      public void getApplication() throws GeneralException
public class CustomWebService extends SailPointRestApplication{
      public Set < Class < ? > > getClasses()
            Set < Class < ? > &gt classes = super.getClasses();


  1. Is there a way to invoke "import filename.xml" command from REST API? If Yes, Kindly share an sample/example code. Thank you.

  2. excellent piece of information, I had come to know about your website from my friend kishore, pune,i have read atleast 8 posts of yours by now, and let me tell you, your site gives the best and the most interesting information. This is just the kind of information that i had been looking for, i'm already your rss reader now and i would regularly watch out for the new posts, once again hats off to you! Thanx a lot once again, Regards, , Sailpoint Online Training

  3. Hi Abhishek,

    Thanks for the timely post,
    at least for me
    . I have encore time wondered about the transition, but somehow did not dare, because the information I came across very controversial.
    But today, after reading your article I’m very confident to take up any challenges.

    Appreciate your effort for making such useful blogs and helping the community.
    Morgan Lee