Manage Shipping Labels

Use the following methods to manage shipping labels for your Windows hardware dashboard submissions. For an introduction to the Microsoft hardware dashboard APIs, including the prerequisites for using the API, see hardware dashboard API.

https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels

Methods for managing shipping labels

Create a new shipping label

1. If you have not done so already, complete all the prerequisites for the Microsoft Hardware APIs.

2. Obtain an Microsoft Entra ID access token. You must pass this access token to the methods in the Microsoft Store submission API. After you obtain an access token, you have 60 minutes to use it before it expires. After the token expires, you can obtain a new one.

3. You should have created a product and submission in order to create a shipping label. See Manage product submissions for details about creating a product and submission.

4. Create a new shipping label for this submission by executing the following method. Use the ProductID and SubmissionID created in Manage product submissions during the previous step.

   https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels
   

   The response body contains a shipping label resource which includes the ID for the newly created shipping label and other details.

Code examples

The following code example demonstrates how to use the Microsoft Hardware API:

• C# sample

Data resources

The Microsoft Hardware APIs methods for creating and managing product data use the following JSON data resource:

• Shipping Label Resource

Error codes

For info about error codes, see Error codes.

See also

• hardware dashboard API samples (GitHub)