Create personCertification
Namespace: microsoft.graph
Create a new personCertification object in a user's profile.
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
| Permission type | Permissions (from least to most privileged) |
|---|---|
| Delegated (work or school account) | User.ReadWrite, User.ReadWrite.All |
| Delegated (personal Microsoft account) | User.ReadWrite, User.ReadWrite.All |
| Application | User.ReadWrite.All |
HTTP request
POST /me/profile/certifications
POST /users/{id | userPrincipalName}/profile/certifications
Request headers
| Name | Description |
|---|---|
| Authorization | Bearer {token}. Required. |
| Content-Type | application/json. Required. |
Request body
In the request body, supply a JSON representation of the personCertification object.
The following table shows the properties that are possible to set when creating a new personCertification object in a user's profile.
| Property | Type | Description |
|---|---|---|
| allowedAudiences | String | The audiences that are able to see the values contained within the entity. Inherited from itemFacet. Possible values are: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone, unknownFutureValue. |
| certificationId | String | The referenceable identifier for the certification. |
| description | String | Description of the certification. |
| displayName | String | Title of the certification. |
| endDate | Date | The date that the certification expires. |
| inference | inferenceData | Contains inference detail if the entity is inferred by the creating or modifying application. Inherited from itemFacet. |
| issuedDate | Date | The date that the certification was issued. |
| issuingAuthority | String | Authority which granted the certification. |
| issuingCompany | String | Authority which granted the certification. |
| source | personDataSource | Where the values originated if synced from another service. Inherited from itemFacet. |
| startDate | Date | The date that the certification became valid. |
| thumbnailUrl | String | URL referencing a thumbnail of the certification. |
| webUrl | String | URL referencing the certification. |
Response
If successful, this method returns a 201 Created response code and an personCertification object in the response body.
Examples
POST https://graph.microsoft.com/beta/me/profile/certifications
Content-Type: application/json
{
"certificationId": "KB-1235466333663322",
"description": "Blackbelt in Marketing - Brand Management",
"displayName": "Marketing Blackbelt - Brand Management",
"thumbnailUrl": "https://iame.io/dfhdfdfd334.jpg",
"webUrl": "https://www.iame.io/blackbelt"
}
Response
Note: The response object shown here might be shortened for readability.
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
"allowedAudiences": "organization",
"inference": null,
"createdDateTime": "2020-07-06T06:34:12.2294868Z",
"createdBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"source": null,
"certificationId": "KB-1235466333663322",
"description": "Blackbelt in Marketing - Brand Management",
"displayName": "Marketing Blackbelt - Brand Management",
"endDate": "Date",
"issuedDate": "Date",
"issuingAuthority": null,
"issuingCompany": null,
"startDate": "Date",
"thumbnailUrl": "https://iame.io/dfhdfdfd334.jpg",
"webUrl": "https://www.iame.io/blackbelt"
}
Feedback
Submit and view feedback for