top of page

Create A SharePoint List using REST API in SharePoint Online and Office 365

Updated: Jan 30, 2020

Welcome to an article on “How to Create a SharePoint List using REST API in SharePoint Online and Office 365” where we will see the steps of creating an app using Napa Tool which will help us to create as many SharePoint lists as we require using REST API.

  • Open the “NAPA” Office 365 Development Tools through your SharePoint store.

  • Click on Add New Project.

  • It will ask you, what type of app do you want to build?


  • Select SharePoint Add-in and provide a name to your app and click on Create.


  • You will see the screen below on the app,


  • Click on Default.aspx and paste the code below under the

  1. <asp:ContentContentPlaceHolderID="PlaceHolderMain" runat="server">”.

Code:

  1. <p>     <b>      Create Custom List</b>     

  2. <br />     

  3. <input type="text" value="Put the custom list name" id="listnameid" />     

  4. <button id="createlistbtn">Create your Custom List</button>  

  5. </p>  

  • Now on the navigation click on the App.js file and paste the code below removing the previous code completely.

Code:

  1. 'use strict';  

  2. var hostweblink;  

  3. var applink;  

  4. // Get the links on load of the app $(document).ready(function() {      

  5. hostweblink = decodeURIComponent(          

  6. getQueryString("SPHostUrl"));      

  7. applink = decodeURIComponent(          

  8. getQueryString("SPAppWebUrl"));  

  9. //Get the function on the button click     

  10. $("#createlistbtn").click(function(event

  11. {          

  12. createcustomlist();  

  13. event.preventDefault();      

  14. });      

  15. var scriptlink = hostweblink + "/_layouts/15/";      

  16. $.getScript(scriptlink + "SP.RequestExecutor.js");  

  17. });  

  18. function getQueryString(paramToRetrieve) 

  19. {      

  20. var paramval = document.URL.split("?")[1].split("&");  

  21. for (var i = 0; i < paramval.length; i = i + 1) 

  22. {          

  23. var paramval1 = paramval[i].split("=");  

  24. if (paramval1[0] == paramToRetrieve) 

  25. return paramval1[1];      

  26. }  

  27. }  

  28. // Create a new custom list

  29. function createcustomlist() 

  30. {     

  31.  var listname = document.getElementById("listnameid").value;      

  32. var play;  

  33. // Initiate the request play      

  34. play = new SP.RequestExecutor(applink);      

  35. play.executeAsync({         

  36.  url: applink + "/_api/SP.AppContextSite(@target)/web/Lists?@target='" + hostweblink + "'",          

  37. method: "POST",          

  38. body: "

  39. { '__metadata': { 'type': 'SP.List' }, 'BaseTemplate': 100,'Description': '" + listname + "', 'Title':'" + listname + "'}",          

  40. headers: {   "content-type": "application/json; odata=verbose"         

  41. },          

  42. success: createlistcompleted,          

  43. error: createlistfailed      

  44. });  

  45. }  

  46. // createlistcompleted

  47. function createlistcompleted(data) {      

  48. alert("Your List Created successfully")  

  49. }  

  50. // createlistfailed

  51. function createlistfailed(data, errorCode, errorMessage) 

  52. {      

  53. alert("Your list creation failed " + errorMessage);  

  54. }  

  • Click on the settings icon on the tool on the left.






  • Under the properties, select Permissions and provide full control to the app on the Site Collection level.


  • Click on the deploy button on the left and run the project.





  • Click on the launch button.


  • Accept the trust and click on ‘Trust It’.


  • Your app will be deployed and open for you as per the following screenshot:


  • Provide a name of the list you want to create and click on ‘Create your Custom List’.


  • Your list will be created by your own app and you can find the list under site contents on the site.

Today we saw how to create a SharePoint List using REST API in SharePoint Online and Office 365. You will love your app. Keep reading and keep learning!



0 comments
bottom of page