Signatures V4

Create a signature request

Uploads a PDF, places signer-owned signature/text fields on it using normalized (0–1) coordinates, and returns one hosted signing link per signer. Requests support one to ten parallel signers. Every field must name its signer key when more than one signer is present. Completed artifacts are certificate-sealed after hardening is enabled. Each signer can receive the request by SMS or WhatsApp, or use the returned signing link.

post/v4/signatures

Request

  • Base URL: https://developer.meetergo.com (the document declares no server; this is the origin it was published from)
  • URL: https://developer.meetergo.com/v4/signatures
  • Auth: one of:
    • API key in header x-meetergo-api-user-id
    • HTTP bearer
    • HTTP bearer

Request body

namestring required

Document / submission name.

filestring required

The source PDF, base64-encoded (max 20 MB decoded).

expiresAtstring

ISO-8601 timestamp after which signing links stop working.

language'en' | 'de'

Signing-page language. Supported: "en", "de". Defaults to English.

completedRedirectUrlstring uri

URL the signer is sent to after completing (DocuSeal completed_redirect_url).

requireOtpboolean

Require email OTP verification. This expresses the FES intent and requires the Suite plan or above.

sendSignedCopyToSignersboolean

Email every signer the finished document when the request completes. Defaults to true. Set false when you distribute the signed document yourself.

automaticRemindersboolean

Send unfinished signers a reminder every three days, up to three reminders.

whatsappTemplateNamestring

Approved WhatsApp template name used by signers whose delivery channel is WhatsApp.

whatsappTemplateLanguagestring

Language code of the selected WhatsApp template.

Example request

{
  "name": "Order confirmation",
  "file": "JVBERi0xLjcKJ...",
  "fields": [
    {
      "name": "signature",
      "signerKey": "customer",
      "type": "signature",
      "areas": [
        {
          "x": 0.1,
          "y": 0.8,
          "w": 0.3,
          "h": 0.08,
          "page": 1
        }
      ]
    }
  ],
  "signers": [
    {
      "key": "customer",
      "email": "john.doe@example.com",
      "name": "John Doe",
      "role": "First Party",
      "deliveryChannel": "sms",
      "phone": "+491723099442"
    }
  ],
  "expiresAt": "2026-12-31T23:59:59.000Z",
  "language": "de",
  "completedRedirectUrl": "https://app.example.com/contracts/123/signed",
  "requireOtp": true,
  "sendSignedCopyToSigners": true,
  "automaticReminders": true,
  "whatsappTemplateName": "signature_invitation",
  "whatsappTemplateLanguage": "de"
}

Response

Signature request created with its signer links.

idstring required

Signature request id.

namestring required

Document name.

schemaVersionnumber required

Persisted envelope schema version.

revisionnumber required

Current request revision.

status'pending' | 'in_progress' | 'finalizing' | 'finalization_failed' | 'completed' | 'cancelled' required

Overall status.

signedDocumentUrlstring nullable

Time-limited download URL for the signed (audit-paged, cryptographically signed) PDF. Present once status is "completed".

completedAtstring date-time nullable

When all signers completed.

expiresAtstring date-time nullable

When signing links expire (null = never).

automaticRemindersboolean required

Whether automatic reminders are enabled.

createdAtstring date-time required

Creation time.

Example response

{
  "signers": [
    {
      "signingUrl": "https://cal.meetergo.com/s/V1StGXR8_Z5jdHi6B-myT"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.