# Delivery creation With this endpoint, you can create up to a maximum of 100 deliveries per request and 100 requests per minute. ## Delivery creation > Create up to 100 deliveries within Shippify ```json {"openapi":"3.0.0","info":{"title":"Shippify Api","version":"1.0.0"},"servers":[{"url":"https://api.shippify.co","description":"Development server"}],"security":[{"Basic_Auth":[]}],"components":{"securitySchemes":{"Basic_Auth":{"type":"http","scheme":"basic"}},"schemas":{"createDelivery":{"successfulResponse":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"payload":{"type":"array","items":{"type":"object","description":"Information of the created delivery","properties":{"index":{"description":"Position of the delivery in the request array","type":"integer","minimum":0},"id":{"type":"string","description":"Shippify delivery identifier"},"price":{"description":"Delivery price","type":"number","minimum":0},"currencyCode":{"type":"string","description":"Currency of the delivery price"},"distance":{"description":"Distance between pickup and delivery points","type":"number","minimum":0},"cityId":{"description":"Pickup city identifier","type":"integer","minimum":1},"destinationCityId":{"description":"Delivery city identifier","type":"integer","minimum":1},"insurance":{"description":"Delivery insurance","type":"number","minimum":0},"statusDelivery":{"type":"string","description":"Current status of the delivery"},"vehicleCapacity":{"description":"Delivery capacity","type":"integer","minimum":1,"maximum":5},"deliveryDate":{"type":"string","description":"Estimated delivery date","format":"date-time"},"trackLink":{"type":"string","description":"Tracking link"},"referenceId":{"type":"string","description":"External identifier of the delivery, can be the order number"}}}}}},"request":{"type":"object","required":["deliveries"],"properties":{"companyId":{"description":"Company identifier where the delivery will be created","type":"integer","minimum":1},"type":{"description":"Delivery type","type":"string","enum":["flex","express","slot"],"default":"slot"},"deliveries":{"type":"array","items":{"$ref":"#/components/schemas/createDelivery/delivery"}}}},"delivery":{"type":"object","required":["pickup","dropoff","packages"],"properties":{"pickup":{"description":"Pickup information","$ref":"#/components/schemas/delivery/place"},"dropoff":{"description":"Delivery information","$ref":"#/components/schemas/delivery/place"},"packages":{"description":"Package information.","type":"array","items":{"$ref":"#/components/schemas/delivery/package"}},"referenceId":{"description":"External identifier of the delivery, can be the order number","type":"string","maxLength":40},"tags":{"description":"Names of digital tags","type":"array","items":{"description":"Name of digital tag","type":"string","maxLength":50}},"extraData":{"description":"Extra delivery data","type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string","description":"Name of the extra information"},"value":{"type":"string","description":"Value of the extra information"}}}},"cod":{"description":"Cash on delivery","type":"number","minimum":0}}}},"Unauthenticated":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"},"delivery":{"place":{"type":"object","required":["contact","location"],"properties":{"contact":{"$ref":"#/components/schemas/delivery/contact"},"location":{"$ref":"#/components/schemas/delivery/location"}}},"contact":{"description":"Contact information of the person responsible for delivering the packages at the pickup warehouse.","type":"object","required":["name","email"],"properties":{"name":{"description":"Name of the responsible person.","type":"string"},"email":{"description":"Email of the responsible person.","type":"string","format":"email"},"phonenumber":{"description":"Phone number of the responsible person.","type":"string"}}},"location":{"description":"Address information of the pickup location of the delivery packages.","type":"object","required":["address"],"properties":{"address":{"description":"Delivery address.","type":"string"},"instructions":{"description":"Extra information about the address.","type":"string"},"lat":{"description":"Latitude of the pickup point.","type":"string"},"lng":{"description":"Longitude of the pickup point.","type":"string"}}},"package":{"type":"object","required":["name","qty","size"],"properties":{"id":{"type":"string","description":"Package identifier"},"name":{"type":"string","description":"Package name"},"qty":{"description":"Number of packages in the order (not the number of products inside the package).","type":"integer","minimum":0},"weight":{"description":"Unit weight * quantity in Kg","type":"number","minimum":0},"size":{"description":"Package size","type":"string","enum":["xs","s","m","l","xl"]},"price":{"description":"Unit price * quantity in the currency of the company","type":"number","minimum":0}}}}}},"paths":{"/v1/deliveries":{"post":{"tags":["Deliveries"],"summary":"Delivery creation","description":"Create up to 100 deliveries within Shippify","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createDelivery/successfulResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthenticated"}}}}},"requestBody":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createDelivery/request"}}}}}}}} ``` ## Use cases
Delivery Creation with Reference ID This is the most basic payload you can use with the API; however, the task may be created with a pending review status if the address cannot be geolocated. 
{
    "deliveries": [
        {
            "pickup": {
                "contact": {
                    "phonenumber": "0976565643",
                    "email": "example@test.com",
                    "name": "Juan Perez"
                },
                "location": {
                    "address": "Av. Francisco de Orellana 8, Guayaquil 090502, Ecuador",
                    "instructions": "Apartamento 203"
                }
            },
            "dropoff": {
                "contact": {
                    "name": "Carlos Perez",
                    "email": "test-1998@hotmail.com"
                },
                "location": {
                    "address": "Malecón 2000, Simon Bolivar Palacios, Guayaquil 090313, Ecuador",
                    "instructions": "Local 890"
                }
            },
            "packages": [
                {
                    "name": "Box of pencils",
                    "qty": 1,
                    "size": 1
                }
            ],
            "referenceId": "FACT-000123"
        }
    ]
}
Delivery Creation with Latitude and Longitude Address With this payload, you can create deliveries with precise pickup and delivery points, ensuring that the task is always created with a "processing" status. ```json { "deliveries": [ { "pickup": { "contact": { "name": "Juan Perez", "phonenumber": "0999999999" }, "location": { "address": "Av. Echeñique 8861, 7860169 La Reina, Región Metropolitana, Chile", "lat": "-33.44299381045172", "lng": "-70.53898694556675" } }, "dropoff": { "contact": { "name": "Carlos Perez", "email": "example@shippify.cl", "phonenumber": "09999999999" }, "location": { "address": "Los Castaños 11989, 8010277 Santiago, El Bosque, Región Metropolitana, Chile", "lat": "-33.56751", "lng": "-70.67549" } }, "packages": [ { "name": "149123156552", "size": "XS", "qty": "1" } ] } ] } ```
Delivery creation with address by components With this payload, you can create deliveries with a slightly more precise pickup or delivery point, reducing the likelihood of it being created as pending review. It involves breaking down the address into country, city, street, and zip code. ```json { "deliveries": [ { "pickup": { "contact": { "name": "Juan Perez", "phonenumber": "0999999999" }, "location": { "address": "R. Dona Claudina, 401 - Méier, Rio de Janeiro - RJ, 20725-060, Brasil", "lat": -22.906846699999996, "lng": -43.28275978125001 } }, "dropoff": { "contact": { "name": "Carlos Perez", "email": "example@shippify.cl", "phonenumber": "09999999999" }, "location": { "address": { "zipcode": "60348450", "neighborhood": "VILA VELHA", "streetName": "RUA 24,656", "state": "CE", "country": "Brazil", "city": "FORTALEZA" }, "instructions": "CONJ DOS BANCARIOS - REF.ENDERECO: PROX A UPA" } }, "packages": [ { "name": "149123156552", "size": "XS", "qty": "1" } ] } ] } ```
Delivery Creation from or to a Configured Warehouse With this payload, you can create deliveries with a collection point previously saved in the "Pickup Locations" [section](https://dash.shippify.co/login?fwd=https://dash.shippify.co/places). ```json { "deliveries": [ { "pickup": { "contact": { "name": "Juan Perez", "phonenumber": "099999999999" }, "location": { "warehouse": 9 } }, "dropoff": { "contact": { "name": "Carlos Perez", "email": "example@shippify.cl", "phonenumber": "099999999999" }, "location": { "address": { "zipcode": "60348450", "neighborhood": "VILA VELHA", "streetName": "RUA 24,656", "state": "CE", "country": "Brazil", "city": "FORTALEZA" }, "instructions": "CONJ DOS BANCARIOS - REF.ENDERECO: PROX A UPA" } }, "packages": [ { "name": "149123156552", "size": "XS", "qty": "1" } ] } ] } ```
Delivery creation with tags and extra data With digital tags, you can add additional features to the task to later filter by them, for example: fragile. With extra data, you can link additional information to the delivery. ```json { "deliveries": [ { "pickup": { "contact": { "phonenumber": "099999999999", "email": "example@test.com", "name": "Juan Perez" }, "location": { "address": "Av. Francisco de Orellana 8, Guayaquil 090502, Ecuador", "instructions": "Apartamento 203" } }, "dropoff": { "contact": { "name": "Carlos Perez", "email": "example@hotmail.com" }, "location": { "address": "Malecón 2000, Simon Bolivar Palacios, Guayaquil 090313, Ecuador", "instructions": "Local 890" } }, "packages": [ { "name": "Caja de colores", "qty": 1, "size": 1 } ], "tags" : [ "fragil" ], "extraData": [ { "name": "GUIA DE REMISION", "value": "0001-000344-2233", "searchable": true } ], "referenceId": "FACT-000123" } ] } ```
Delivery creation for a child company With this payload, you can create deliveries for a child company with authorization from the parent company. 
{
    "companyId":2,
    "deliveries": [
        {
            "pickup": {
                "contact": {
                    "phonenumber": "09999999999",
                    "email": "example@test.com",
                    "name": "Juan Perez"
                },
                "location": {
                    "address": "Av. Francisco de Orellana 8, Guayaquil 090502, Ecuador",
                    "instructions": "Apartamento 203"
                }
            },
            "dropoff": {
                "contact": {
                    "name": "Carlos Perez",
                    "email": "example@hotmail.com"
                },
                "location": {
                    "address": "Malecón 2000, Simon Bolivar Palacios, Guayaquil 090313, Ecuador",
                    "instructions": "Local 890"
                }
            },
            "packages": [
                {
                    "name": "Caja de colores",
                    "qty": 1,
                    "size": 1
                }
            ],
            "referenceId": "FACT-000123"
        }
    ]
}
[^1]: Identificador de la compañía hija --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.shippify.co/developers/en/shippify-api/deliveries/delivery-creation.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.