SharePoint Online: Write User Profile Properties with REST API

In my previous posts, we saw how to Set user profile properties using JSOM & JavaScript and Set another user's profile properties with CSOM

Now, here are some code snippets I have put together to set SharePoint User Profile properties with the SharePoint REST API

• This code only works with SharePoint Online at this time.
• Can be used to set single value as well as multi value user profile properties.
• Can be used to set default (OOB) as well as custom user profile properties.

1) Set Single Value User Profile property with REST API:

	(function ($) {
	'use strict';
	var requestHeaders = {
	'X-RequestDigest': $("#__REQUESTDIGEST").val(),
	"accept": "application/json; odata=nometadata",
	"content-type": "application/json;odata=nometadata"
	};
	var userData = {
	'accountName': "i:0#.f|membership|user@yourtenant.onmicrosoft.com",
	'propertyName': 'AboutMe', //can also be used to set custom single value profile properties
	'propertyValue': 'Value set from REST API!'
	}
	$.ajax({
	url: _spPageContextInfo.webAbsoluteUrl + "/_api/SP.UserProfiles.PeopleManager/SetSingleValueProfileProperty",
	type: "POST",
	headers: requestHeaders,
	data: JSON.stringify(userData),
	success: function (data) {
	console.log(data)
	},
	error: function (jqxr, errorCode, errorThrown) {
	console.log(jqxr.responseText);
	}
	});
	})(jQuery);

view raw Set.Single.UserProfileProperty.js hosted with ❤ by GitHub

2) Set Mutli Value User Profile property with REST API:

	(function ($) {
	'use strict';
	var requestHeaders = {
	'X-RequestDigest': $("#__REQUESTDIGEST").val(),
	"accept": "application/json; odata=nometadata",
	"content-type": "application/json;odata=nometadata"
	};
	var userData = {
	'accountName': "i:0#.f|membership|user@yourtenant.onmicrosoft.com",
	'propertyName': 'SPS-Skills', //Can also set custom userprofile properties.
	'propertyValues': ["SharePoint", "Office 365", "Architecture", "Azure"]
	};
	$.ajax({
	url: _spPageContextInfo.webAbsoluteUrl + "/_api/SP.UserProfiles.PeopleManager/SetMultiValuedProfileProperty",
	type: "POST",
	headers: requestHeaders,
	data: JSON.stringify(userData),
	success: function (data) {
	console.log(data)
	},
	error: function (jqxr, errorCode, errorThrown) {
	console.log(jqxr.responseText);
	}
	});
	})(jQuery);

view raw Set.Mult.UserProfileProperty.js hosted with ❤ by GitHub

Hope you find this useful!

SharePoint Online: Get UserProfile Properties with REST API Batching

In my previous post SharePoint 2013: Get UserProfile Properties with REST API, we saw how to fetch SharePoint UserProfile properties with the REST API.

The only thing missing in that post was, at the time there was no way to get Multiple UserProfile Properties for a Specific User i.e. if you had an account name of a user and wanted to fetch multiple custom or default UserProfile properties, you could not do that in a single REST call. You would have to resort to either making multiple REST calls using the GetUserProfilePropertyFor function, or you would have to use the JavaScript Client Object Model (JSOM)

When I wrote that post, SharePoint Online did not support REST API batching. Since then, it has been implemented and as a result we can get multiple Custom/OOB User Profile properties in a single REST call.

Here is my code showing how to do it:

	(function ($) {
	'use strict';
	//AccountName of the user
	var userAccountName = encodeURIComponent("i:0#.f|membership|user@yourtenant.onmicrosoft.com");
	//User Profile Properties to fetch
	var propertiesToGet = ["AccountName", "PictureURL", "CustomUserProfileProp1", "CustomUserProfileProp2"];
	//Unique identifier, will be used to delimit different parts of the request body
	var boundryString = getBoundryString();
	//Build Body of the Batch Request
	var userPropertiesBatchBody = buildBatchRequestBody(userAccountName, propertiesToGet, boundryString);
	//Build Header of the Batch Request
	var batchRequestHeader = buildBatchRequestHeader(userPropertiesBatchBody, boundryString);
	//Make the REST API call to the _api/$batch endpoint with the batch data
	var requestHeaders = {
	'X-RequestDigest': jQuery("#__REQUESTDIGEST").val(),
	'Content-Type': 'multipart/mixed; boundary="batch_' + boundryString + '"'
	};
	$.ajax({
	url: _spPageContextInfo.webAbsoluteUrl + "/_api/$batch",
	type: "POST",
	headers: requestHeaders,
	data: batchRequestHeader,
	success: function (batchResponse) {
	//Convert the text response to an array containing JSON objects of the results
	var results = parseResponse(batchResponse);
	//Properties will be returned in the same sequence they were added to the batch request
	for (var i = 0; i < propertiesToGet.length; i++) {
	console.log(propertiesToGet[i] + " is " + results[i].value);
	}
	},
	error: function (jqxr, errorCode, errorThrown) {
	console.log(jqxr.responseText);
	}
	});
	//Build the batch request for each property individually
	function buildBatchRequestBody(userAccountName, propertiesToGet, boundryString) {
	var propData = new Array();
	for (var i = 0; i < propertiesToGet.length; i++) {
	var getPropRESTUrl = _spPageContextInfo.webAbsoluteUrl + "/_api/SP.UserProfiles.PeopleManager/GetUserProfilePropertyFor(accountName=@v,propertyName='" + propertiesToGet[i] + "')?@v='" + userAccountName + "'";
	propData.push('--batch_' + boundryString);
	propData.push('Content-Type: application/http');
	propData.push('Content-Transfer-Encoding: binary');
	propData.push('');
	propData.push('GET ' + getPropRESTUrl + ' HTTP/1.1');
	propData.push('Accept: application/json;odata=nometadata');
	propData.push('');
	}
	return propData.join('\r\n');
	}
	//Build the batch header containing the user profile data as the batch body
	function buildBatchRequestHeader(userPropsBatchBody, boundryString) {
	var headerData = new Array();
	headerData.push('Content-Type: multipart/mixed; boundary="batch__' + boundryString + '"');
	headerData.push('Content-Length: ' + userPropsBatchBody.length);
	headerData.push('Content-Transfer-Encoding: binary');
	headerData.push('');
	headerData.push(userPropsBatchBody);
	headerData.push('');
	headerData.push('--batch_' + boundryString + '--');
	return headerData.join('\r\n');
	}
	function parseResponse(batchResponse) {
	//Extract the results back from the BatchResponse
	var results = $.grep(batchResponse.split("\r\n"), function (responseLine) {
	try {
	return responseLine.indexOf("{") != -1 && typeof JSON.parse(responseLine) == "object";
	}
	catch (ex) { /*adding the try catch loop for edge cases where the line contains a { but is not a JSON object*/ }
	});
	//Convert JSON strings to JSON objects
	return $.map(results, function (result) {
	return JSON.parse(result);
	});
	}
	function getBoundryString() {
	return "vrd_" + Math.random().toString(36).substr(2, 9);
	}
	})(jQuery);

view raw SPO.REST.Batching.js hosted with ❤ by GitHub

Here are some other great resources on SharePoint REST API Batching:

Batch Processing (OData Version 3.0)

Part 1 - SharePoint REST API Batching - Understanding Batching Requests

Make batch requests with the REST APIs

Thanks for reading!