--- title: "Create a new manifest" method: POST path: "/manifests" tags: ["Manifests"] --- # Create a new manifest `POST /manifests` Creates a new manifest object. ## Headers - `SHIPPO-API-VERSION` string ## Request body - ManifestCreateRequest - `carrier_account` string, required — ID of carrier account - `shipment_date` string, required — All shipments to be submitted on this day will be closed out. Must be in the format `2014-01-18T00:35:03.463Z` (ISO 8601 date). - `transactions` string[] — IDs transactions to use. If you set this to null or not send this parameter, Shippo will automatically assign all applicable transactions. - `address_from` union, required - AddressCreateRequest — Address represents the address as retrieved from the database - `name` string — **required for purchase** First and Last Name of the addressee **Carrier-Specific Constraints:** | Carrier | Constraints | |:---|:---| | FedEx | Either company or name required; No length validation (first 35 chars printed on label) | - `company` string — Company Name **Carrier-Specific Constraints:** | Carrier | Constraints | |:---|:---| | FedEx | Max 35 characters; Either company or name required | - `street1` string — **required for purchase** First street line. Usually street number and street name (except for DHL Germany, see street_no). **Carrier-Specific Constraints:** | Carrier | Constraints | |:---|:---| | FedEx | At least one street line required; Max 35 characters per line | - `street2` string — Second street line. **Carrier-Specific Constraints:** | Carrier | Constraints | |:---|:---| | FedEx | At least one street line required; Max 35 characters per line | - `street3` string — Third street line. Only accepted for USPS international shipments, UPS domestic and UPS international shipments. **Carrier-Specific Constraints:** | Carrier | Constraints | |:---|:---| | FedEx | At least one street line required; Max 35 characters per line | - `street_no` string — Street number of the addressed building. This field can be included in street1 for all carriers except for DHL Germany. - `city` string — **required for purchase** Name of a city. When creating a Quote Address, sending a city is optional but will yield more accurate Rates. Please bear in mind that city names may be ambiguous (there are 34 Springfields in the US). Pass in a state or a ZIP code (see below), if known, it will yield more accurate results. **Carrier-Specific Constraints:** | Carrier | Constraints | |:---|:---| | FedEx | Required; Max 35 characters | - `state` string — **required for purchase for some countries** State/Province values are required for shipments from/to the US, AU, and CA. UPS requires province for some countries (i.e Ireland). To receive more accurate quotes, passing this field is recommended. Most carriers only accept two or three character state abbreviations. **Carrier-Specific Constraints:** | Carrier | Constraints | |:---|:---| | FedEx | Required if country requires state; Max 2 characters for US, CA, PR | - `zip` string — **required for purchase** Postal code of an Address. When creating a Quote Addresses, sending a ZIP is optional but will yield more accurate Rates. **Carrier-Specific Constraints:** | Carrier | Constraints | |:---|:---| | FedEx | Max 10 characters | - `country` string, required — ISO 3166-1 alpha-2 country codes and country names can be used. For most consistent results, we recommend using country codes like `US` or `DE`. If using country names, please ensure they are spelled correctly and in English. Country names are converted to country codes. Refer to this [guide](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) for a list of country codes. Sending a country is always required. - `phone` string — Addresses containing a phone number allow carriers to call the recipient when delivering the Parcel. This increases the probability of delivery and helps to avoid accessorial charges after a Parcel has been shipped. **Carrier-Specific Constraints:** | Carrier | Constraints | |:---|:---| | FedEx | Required; Min 1, max 15 characters | | USPS | Sender phone required for shipments during label purchase; Min 8, max 15 digits | - `email` string — E-mail address of the contact person, RFC3696/5321-compliant. **Carrier-Specific Constraints:** | Carrier | Constraints | |:---|:---| | FedEx | Max 80 characters | | USPS | Sender email required for shipments during label purchase | - `is_residential` boolean - `metadata` string — A string of up to 100 characters that can be filled with any additional information you want to attach to the object. - `validate` boolean — Set to true to validate Address object. - string — ID of the Address object that should be used as pickup address for the scan form. The USPS will validate this address before creating the scan form. - `async` boolean ## Response `201` Manifest - Manifest - `carrier_account` string, required — ID of carrier account - `shipment_date` string, required — All shipments to be submitted on this day will be closed out. Must be in the format `2014-01-18T00:35:03.463Z` (ISO 8601 date). - `transactions` string[] — IDs transactions to use. If you set this to null or not send this parameter, Shippo will automatically assign all applicable transactions. - `address_from` string, required — ID of the Address object that should be used as pickup address for the scan form. The USPS will validate this address before creating the scan form. - `documents` string[], required — An array containing the URLs to all returned manifest documents. - `errors` string[] — An array of codes and messages describing the error that occurred if any. - `object_created` string, date-time, required — Date and time of object creation. - `object_id` string, required — Unique identifier of the given object. - `object_owner` string, required — Username of the user who created the object. - `object_updated` string, date-time, required — Date and time of last object update. - `status` 'QUEUED' | 'SUCCESS' | 'ERROR', required — Indicates the status of the manifest. ## Other responses - `400` — Bad request --- [API](https://skmtc.net/goshippo/apis/shippo-external-api.md) · [All operations](https://skmtc.net/goshippo/apis/shippo-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goshippo/shippo-external-api/revisions/13280a44853c/schema)