# Upload Documents

### Hosted on Shiptify or not

Thanks to **save** attribute, you have the choice to:

* Either provide the link to a document hosted **out of** Shiptify
* Or provide the file itself so the document is hosted **within** Shiptify

### Authentication

Please be in touch with your Shiptify contact for <mark style="color:blue;">Authentication</mark> questions.

### Endpoint to use

{% openapi src="<https://126269492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSUDs2RghltJWD9LPsGGQ%2Fuploads%2FRjiijD54qhlygdJLVPq7%2Fshiptify-public-api.openapi.json?alt=media&token=b64eb81b-d262-4bf5-98d5-254e00aec99f>" path="/shipments/{id}/upload" method="post" %}
[shiptify-public-api.openapi.json](https://126269492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSUDs2RghltJWD9LPsGGQ%2Fuploads%2FRjiijD54qhlygdJLVPq7%2Fshiptify-public-api.openapi.json?alt=media\&token=b64eb81b-d262-4bf5-98d5-254e00aec99f)
{% endopenapi %}