SignDocs Brasil icon

SignDocs Brasil

Send documents for electronic signature via SignDocs Brasil

Actions18

Trust Session → Create

AI-generated

Summary

Creates a SignDocs Brasil trust session to authenticate an action without a document. Sends the signer to a hosted page for the selected authentication steps and returns the session response with a signingUrl that includes the client secret.

Inputs

  • Policy Profile — Authentication strength: biometric, OTP, SERPRO cross-check or fallback, document-photo fallback, click plus OTP, click only, or custom. Defaults to biometric; digital certificate is unavailable for trust sessions.
  • Action Type (required) — Machine-readable identifier for the action being authenticated, used in the evidence pack and audit trail.
  • Action Description (required) — Human-readable explanation shown to the signer and captured in the evidence pack.
  • Signer Name (required) — Signer’s name.
  • Signer External ID (required) — Your system’s identifier for the signer, used for audit trails.
  • Additional Fields — Optional action reference; cancel and return URLs; expiration in minutes (default 60); idempotency key; locale (default pt-BR); JSON metadata; OTP channel (default email); owner email and name for invitation and completion notifications; and signer birth date, CNPJ, CPF, email, or phone. Signer contact and identity details are included when provided.

Output shape

A single JSON item containing the API’s trust-session response fields plus signingUrl.

The node POSTs to /v1/trust-sessions and builds signingUrl by adding the returned client secret to the returned URL as the cs query parameter. With Continue On Fail enabled, an item-level error object is returned for failures.

Links

Discussion