Actions18
- Document Actions
- Envelope Actions
- Evidence Actions
- Signing Session Actions
- Trust Session Actions
- Webhook Actions
Trust Session → Create
AI-generatedSummary
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-sessionsand buildssigningUrlby adding the returned client secret to the returned URL as thecsquery parameter. With Continue On Fail enabled, an item-level error object is returned for failures.