ESC
Type to search...

Printer.Create

Export JSON
Export CSV
Copy URL
Print
Delegated Read User Scope

Allows the application to create (register) printers on behalf of the signed-in user.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Delegated Permission Admin consent required

Register printers

Allows the application to create (register) printers on behalf of the signed-in user.

Properties

Microsoft Graph v1.0 exact-category-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property Type Description
capabilities printerCapabilities The capabilities of the printer associated with this printer share. Inherited from printerBase.
defaults printerDefaults The printer's default print settings. Inherited from printerBase.
displayName String The name of the printer. Inherited from printerBase.
hasPhysicalDevice Boolean True if the printer has a physical device for printing. Read-only.
id String The document's identifier. Inherited from printerBase. Read-only.
isAcceptingJobs BooleanNullable True if the printer is currently accepting new print jobs. Inherited from printerBase.
isShared Boolean True if the printer is shared; false otherwise. Read-only.
lastSeenDateTime DateTimeOffsetNullable The most recent dateTimeOffset when a printer interacted with Universal Print. Read-only.
location printerLocation The physical and/or organizational location of the printer. Inherited from printerBase.
manufacturer StringNullable The manufacturer reported by the printer. Inherited from printerBase.
model StringNullable The model name reported by the printer. Inherited from printerBase.
registeredDateTime DateTimeOffset The DateTimeOffset when the printer was registered. Read-only.
status printerStatus The processing status of the printer, including any errors. Inherited from printerBase.
connectors printConnector collection The connectors that are associated with the printer.
jobs printJob collection The list of jobs that are queued for printing by the printer/printerShare.

Showing 15 of 17 properties.

JSON Representation

Microsoft Graph v1.0 exact-category-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation
{
  "@odata.type": "#microsoft.graph.printer",
  "id": "String (identifier)",
  "displayName": "String",
  "manufacturer": "String",
  "model": "String",
  "isAcceptingJobs": "Boolean",
  "defaults": {
    "@odata.type": "microsoft.graph.printerDefaults"
  },
  "location": {
    "@odata.type": "microsoft.graph.printerLocation"
  },
  "capabilities": {
    "@odata.type": "microsoft.graph.printerCapabilities"
  },
  "status": {
    "@odata.type": "microsoft.graph.printerStatus"
  },
  "registeredDateTime": "String (timestamp)",
  "isShared": "Boolean",
  "hasPhysicalDevice": "Boolean",
  "lastSeenDateTime": "String (timestamp)"
}

Relationships

Microsoft Graph v1.0 exact-category-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship Type Description
connectors printConnector The connectors that are associated with the printer.
jobs printJob collection The list of jobs that the printer queues for printing. Inherited from printerBase.
shares printerShare collection The list of printerShares that are associated with the printer. Currently, only one printerShare can be associated with the printer. Read-only. Nullable.
taskTriggers printTaskTrigger collection A list of task triggers that are associated with the printer.
status printerStatus Related status data exposed by this resource.

Graph Methods

Delegated access App-only access
Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /print/operations/{printOperationId}
GET /print/services
GET /print/services/{printServiceId}
GET /print/services/{printServiceId}/endpoints
GET /print/services/{printServiceId}/endpoints/{printServiceEndpointId}
POST /print/printers/create
Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /print/operations/{id}
GET /print/services
GET /print/services/{id}
GET /print/services/{id}/endpoints
GET /print/services/{id}/endpoints/{name}
POST /print/printers/create
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgPrintOperation /print/operations/{printOperationId}
Get printOperation
Get-MgPrintService /print/services
List printServices
Get-MgPrintService /print/services/{printServiceId}
Get printService
Get-MgPrintServiceEndpoint /print/services/{printServiceId}/endpoints
List endpoints
Get-MgPrintServiceEndpoint /print/services/{printServiceId}/endpoints/{printServiceEndpointId}
Get printServiceEndpoint
New-MgPrintPrinter /print/printers/create
printer: create
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgBetaPrintOperation /print/operations/{id}
Get printOperation
Get-MgBetaPrintService /print/services
List printServices
Get-MgBetaPrintService /print/services/{id}
Get printService
Get-MgBetaPrintServiceEndpoint /print/services/{id}/endpoints
List printServiceEndpoints
Get-MgBetaPrintServiceEndpoint /print/services/{id}/endpoints/{name}
Get printServiceEndpoint
New-MgBetaPrintPrinter /print/printers/create
printer: create

Code Examples

C# / .NET SDK
Get printOperation
// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Print.Operations["{printOperation-id}"].GetAsync();
JavaScript
Get printOperation
const options = {
	authProvider,
};

const client = Client.init(options);

let printOperation = await client.api('/print/operations/{printOperationId}')
	.get();
PowerShell
Get printOperation
Import-Module Microsoft.Graph.Devices.CloudPrint

Get-MgPrintOperation -PrintOperationId $printOperationId
Python
Get printOperation
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.print.operations.by_print_operation_id('printOperation-id').get()

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Delegated permissions and search for Printer.Create

4

Grant Admin Consent

This delegated permission requires admin consent.