Create Signature Request

After uploading a document, the next step is to initiate a signature request.Depending on the workflow, you can choose from four signature request types.

Endpoint

POST /api/v2/requests?type={0|1|2|3}

Headers

Header	Value	Description
Authorization	Bearer {access_token}	OAuth 2.0 token obtained during authentication
Content-Type	application/json	Required for sending JSON formatted payloads

Request Types

Type	Name	Description
0	Skeleton (Automation / RPA)	Step-by-step creation using separate calls for signatories and stamps.
1	Template-Based	Uses a predefined template configured within Evia Sign.
2	Fixed Positioning	Manually define exact coordinates for each stamp/signature.
3	Auto-Stamping	Automatically places signatures based on smart tags in the document.

Common Payload Fields

Field	Type	Description
Title	string	Title of the signature request.
Message	string	Optional message for signatories.
Documents	array	Array of uploaded document tokens.
CallbackUrl	string	Webhook URL to receive status updates.
CallbackTypes	array	Events to trigger callbacks (e.g., request.sent, completed).
CompletedDocumentsAttached	boolean	Whether to attach the completed document in callbacks.

Example Payloads

Type 0 (Skeleton - Automation/RPA)

Create the request first, then separately add signatories and stamps.

{
  "Title": "Contract Agreement",
  "Message": "Please review",
  "Documents": ["abc123-token"],
  "CallbackUrl": "https://yourdomain.com/webhook",
  "CallbackTypes": [0, 1, 2, 3],
  "CompletedDocumentsAttached": false
}

Type 1 (Template-Based)

Utilizes an existing template, predefining roles and stamp placements.

{
  "templateId": "05117898-90db-45e5-b6b8-0230fd326e4f",
  "signatories": [
    {
      "roleId": "role-id-1",
      "signatoryUserName": "Alice",
      "signatoryUserEmail": "[e-mail]"
    }
  ]
}

Type 2 (Fixed Positioning)

You define exactly where each signature or stamp should appear.

{
  "Title": "Fixed Contract",
  "Documents": ["abc123-token"],
  "SignInOrder": false,
  "Signatories": [
    {
      "Email": "[e-mail]",
      "Name": "John",
      "Order": 1,
      "SignatoryType": 1,
      "Stamps": [
        {
          "DocumentToken": "abc123-token",
          "Location": { "X": 400, "Y": 300 },
          "StampSize": { "Width": 100, "Height": 50 },
          "PageNumber": 1,
          "Type": "signature"
        }
      ]
    }
  ]
}

Type 3 (Auto-Stamping)

The API finds smart tag placeholders (e.g., {{signature1}}) inside the PDF and automatically places the stamp.

{
  "Title": "Auto Stamping",
  "Documents": ["abc123-token"],
  "Signatories": [
    {
      "Email": "[e-mail]",
      "Name": "Jane",
      "Order": 1,
      "SignatoryType": 1,
      "AutoStamps": [
        {
          "Identifier": "signature1",
          "Type": "signature",
          "Offset": { "X_offset": 0, "Y_offset": -50 },
          "StampSize": { "Width": 100, "Height": 50 }
        }
      ]
    }
  ]
}