---
title: "Upload document from URL"
method: POST
path: "/v2/documents/url"
---

# Upload document from URL

`POST /v2/documents/url`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/documents/url`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/documents/url/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to upload a document to their SignNow account from a URL.

Accepts .pdf, .doc, .docx, .odt, .rtf, .png, .jpg, .jpeg, .gif, .bmp, .xml, .xls, .xlsx, .ppt, .pptx, .ps, and .eps file types.

Maximum file size per upload is 50 MB.

> The link to the document must be publicly accessible.

## Request body

- object
  - `url` string, required: URL with the file to upload. The link to the file must be publicly accessible.
  - `check_fields` boolean: If true, you can upload a document with simple text tags. For more information, see [Upload document with tags](/docs/document/operations/upload-document-with-text-tags).

## Response `200`

Success: ID of the uploaded document.

- object
  - `id` string: ID of the uploaded document.

## Other responses

- `400`: * Wrong, expired, or missing token. * The document name is longer than `255` characters. * The file can't be uploaded from the URL: the URL is empty or malformed, points to a private or restricted host, or the file can't be downloaded.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)
