---
title: "Upload document with tags"
url: "https://docs.signnow.com/docs/document/operations/upload-document-with-text-tags"
type: "endpoint"
section: "document"
slug: "document/operations/upload-document-with-text-tags"
method: "POST"
path: "/document/fieldextract"
operation_id: "upload-document-with-text-tags"
authorization: "bearer"
---

# Upload document with tags

`POST /document/fieldextract`

This endpoint allows users to upload a document with text tags. 

Text tags can be of two types: simple and complex. **Simple text tags** use curly brackets and a notation system to define fields. **Complex text tags** use only field names on a document; field details are provided separately in the `Tags` array. 
> Only .doc, .docx, and .pdf formats are supported.

**Additional parameters**

`parse_type`: determines how the document text tags are parsed. 

Possible values:

- `tag`: parse only simple tags. All Adobe (fillable) fields will be removed from the document without saving.

- `adobe`: parse only Adobe (fillable) fields. All simple tags will be removed from the document without saving.

- `all`: parse both simple tags and Adobe (fillable) fields. Also parses simple tags added inside Adobe fields as their content.

- `default` (or if `parse_type` not specified): parse simple and complex tags and Adobe (fillable) fields. Simple tags added as the content of Adobe fields will not be parsed.

For more information, see the [Text tags](/docs/text-tags) guide or check out our video tutorials:

<details open>

**<summary>Simple text tags video tutorial</summary>**

<sub><sup>Note: The design shown in the video is outdated, but the flow is still accurate. You can go ahead and follow the steps as demonstrated.</sup></sub>

[Simple text tags video tutorial](https://www.youtube.com/watch?v=iopDT5_4-Co)

</details>
<br>

<details open>

**<summary>Complex text tags video tutorial</summary>**

<sub><sup>Note: The design shown in the video is outdated, but the flow is still accurate. You can go ahead and follow the steps as demonstrated.</sup></sub>

[Complex text tags video tutorial](https://www.youtube.com/watch?v=V0YWL2T8F-o)

</details>

## Authorization

bearer

## Form Data Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `file` | string | Yes | @/path/to/your/file.pdf |
| `Tags[]:` | string | No | A JSON array of complex text tags in the document. Example: {     "tag_name": "EmployeeName",     "role": "Employee",     "label": "Your name",     "required": true,     "type": "text",     "width": 100,     "height": 20 } |
| `parse_type` | string | No | Determines the parse flow for document text tags. Possible values:  `tag`, `adobe`, `all`, `default`.  |

## Responses

### 200

**Example** (`application/json`)

```json
{
  "id": "3dXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
```

## Code Examples

> Replace `$SIGNNOW_ACCESS_TOKEN` and any `{placeholder}` values before running.

### cURL

```bash
curl -X POST \
  "https://api.signnow.com/document/fieldextract" \
  -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN" \
  -H "Content-Type: application/json"
```

---
*Full reference: https://docs.signnow.com/docs/document/operations/upload-document-with-text-tags*