---
title: "Create a new user parcel template"
method: POST
path: "/user-parcel-templates"
tags: ["User Parcel Templates"]
---

# Create a new user parcel template

`POST /user-parcel-templates`

Creates a new user parcel template.

You can choose to create a
parcel template using a preset carrier template as a starting point, or
you can create an entirely custom one. To use a preset carrier template,
pass in a unique template token from [this list](/shippoapi/public-api/parcel-templates)
plus the weight fields (**weight** and **weight_unit**). Otherwise, omit
the template field and pass the other fields, for the weight, length, height,
and depth, as well as their units."

## Headers

- `SHIPPO-API-VERSION` string

## Request body

- union
  - UserParcelTemplateWithCarrierTemplateCreateRequest
    - `template` string — The object representing the carrier parcel template
    - `weight` string — The weight of the package, in units specified by the weight_unit attribute.
    - `weight_unit` 'g' | 'kg' | 'lb' | 'oz' — The unit used for weight.
  - UserParcelTemplateWithoutCarrierTemplateCreateRequest
    - `distance_unit` 'cm' | 'in' | 'ft' | 'm' | 'mm' | 'yd', required — The measure unit used for length, width and height.
    - `height` string, required — The height of the package, in units specified by the `distance_unit` attribute. Required, but if using a preset carrier template then this field must be empty.
    - `length` string, required — The length of the package, in units specified by the `distance_unit` attribute. Required, but if using a preset carrier template then this field must be empty.
    - `name` string, required — The name of the User Parcel Template
    - `weight` string — The weight of the package, in units specified by the weight_unit attribute.
    - `weight_unit` 'g' | 'kg' | 'lb' | 'oz' — The unit used for weight.
    - `width` string, required — The width of the package, in units specified by the `distance_unit` attribute. Required, but if using a preset carrier template then this field must be empty.

## Response `200`

User parcel template

- UserParcelTemplate
  - `distance_unit` 'cm' | 'in' | 'ft' | 'm' | 'mm' | 'yd' — The measure unit used for length, width and height.
  - `height` string — The height of the package, in units specified by the `distance_unit` attribute. Required, but if using a preset carrier template then this field must be empty.
  - `length` string — The length of the package, in units specified by the `distance_unit` attribute. Required, but if using a preset carrier template then this field must be empty.
  - `name` string — The name of the User Parcel Template
  - `weight` string — The weight of the package, in units specified by the weight_unit attribute.
  - `weight_unit` 'g' | 'kg' | 'lb' | 'oz' — The unit used for weight.
  - `width` string — The width of the package, in units specified by the `distance_unit` attribute. Required, but if using a preset carrier template then this field must be empty.
  - `object_created` string, date-time — Date and time of User Parcel Template creation
  - `object_id` string — Unique identifier of the given User Parcel Template object
  - `object_owner` string — Username of the user who created the User Parcel Template object
  - `object_updated` string, date-time — Date and time of last update on User Parcel Template
  - `template` CarrierParcelTemplate
    - `carrier` string — The name of the carrier that provides this parcel template
    - `distance_unit` 'cm' | 'in' | 'ft' | 'm' | 'mm' | 'yd' — The measure unit used for length, width and height.
    - `height` string — The height of the package, in units specified by the distance_unit attribute
    - `is_variable_dimensions` boolean — True if the carrier parcel template allows custom dimensions, such as USPS Softpack.
    - `length` string — The length of the package, in units specified by the distance_unit attribute
    - `name` string — The name of the carrier parcel template
    - `token` string — The unique string representation of the carrier parcel template
    - `width` string — The width of the package, in units specified by the distance_unit attribute

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/goshippo/apis/shippo-address-api.md) · [All operations](https://skmtc.net/goshippo/apis/shippo-address-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goshippo/shippo-address-api/revisions/26fcc6af452a/schema)