> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.sign.plus/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Text annotation

<Frame>
  <img className="block" src="https://mintcdn.com/alohi/KnYKDC0EFTC2S5WS/resources/guides/add-text-annotation.svg?fit=max&auto=format&n=KnYKDC0EFTC2S5WS&q=85&s=60829bd641140c269820651e4fa5fd41" alt="Add text annotation" width="733" height="314" data-path="resources/guides/add-text-annotation.svg" />
</Frame>

A **Text Annotation** serves as a designated placeholder within a document where the recipient is required to enter text. You can include one or more text annotations in a document. Learn more about [Annotations](/concepts/annotation).

You will also need to add a document to the envelope and set a recipient using signing steps. You will get the `recipient_id` from the response of the signing steps and the `document_id` from the response of the document upload.

<Note>Coordinates of the annotation are passed in % of the page dimensions (from 0 to 100) counting from the top left corner</Note>

```bash Add annotation theme={null}
curl --request POST \
  --url https://restapi.sign.plus/v2/envelope/{envelope_id}/annotation \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "recipient_id": "<string>",
  "document_id": "<string>",
  "page": 1,
  "x": 50,
  "y": 20,
  "width": 20,
  "height": 60,
  "required": true,
  "type": "TEXT",
  "signature": null,
  "initials": null,
  "text": {
   "size": 12,
    "color": 32,
    "value": "Enter your insurance number",
    "font": {
      "family": "SERIF",
      "italic": true,
      "bold": true
    }},
  "datetime": null,
  "checkbox": null
}'
```

On success, the API will return the inserted annotation.

<Card horizontal title="API Reference" icon="code" href="/api-reference/endpoints/signplus/add-envelope-annotation">
  Get endpoint details
</Card>