> ## 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 Signature annotation

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

A **Signature Annotation** serves as a designated placeholder within a document where the recipient is required to sign. You can include one or more signature annotations in a document. These annotations can be added alongside other types of annotations, such as text fields, date fields, and checkboxes. For further details, visit [Annotation](/concepts/annotation).

Before adding the annotation, you need to define your signature in the Sign.Plus platform.

<Frame>
  <video controls>
    <source src="https://mintcdn.com/alohi/KnYKDC0EFTC2S5WS/resources/get-started/quickstart/define-signature.mp4?fit=max&auto=format&n=KnYKDC0EFTC2S5WS&q=85&s=bada09f54d93facc4827698b1f9041bb" type="video/mp4" data-path="resources/get-started/quickstart/define-signature.mp4" />

    Your browser does not support the video tag.
  </video>
</Frame>

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 that you can only add a signature annotation on a recipient that has a `SIGNER` role.

<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": "SIGNATURE",
  "signature": {
    "id": ""
  },
  "initials": null,
  "text": null,
  "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>
