Autentique icon

Autentique

Trabalhe com dados da API do Autentique para assinaturas digitais

Actions22

Document → Add Signatory

AI-generated

Overview

This node operation adds a new signatory to an existing document in the Autentique digital signature platform. It is useful for workflows that require dynamically adding signers to documents for signing, approval, or witnessing. For example, a contract management process can use this node to add stakeholders as signatories via email or phone, specifying their signing action and delivery method.

Use Case Examples

  1. Adding a signatory by email to a contract document for signing.
  2. Adding a signatory by phone with WhatsApp delivery for approval.
  3. Adding a signatory by name only, generating a signing link without contact details.

Properties

Name Meaning
Document ID The unique identifier of the document to which the signatory will be added.
Contact Method The method used to contact the signatory, such as email, phone, or name only (which generates a link).
Signatory Email The email address of the signatory, required if contact method is email.
Signatory Phone The phone number of the signatory in international format, required if contact method is phone.
Signatory Name The name of the signatory, optional for email or phone contact, but required if contact method is name only.
Action The action the signatory is expected to perform on the document, such as signing, approving, signing as a witness, or recognizing the signature.
Delivery Method The method to deliver the signing invitation, required if contact method is phone, with options like WhatsApp or SMS.

Output

JSON

  • createSigner
    • public_id - The public identifier of the newly added signatory.
    • name - The name of the signatory.
    • email - The email of the signatory.
    • delivery_method - The delivery method used to contact the signatory.
    • action
      * name - The action assigned to the signatory.
    • link
      * id - The identifier of the signing link.
      * short_link - The short URL link for the signatory to access the document.
    • created_at - The timestamp when the signatory was added.

Dependencies

  • Autentique API with an API key credential

Troubleshooting

  • Ensure the Document ID is valid and exists in the Autentique system.
  • Verify that the signatory contact method matches the provided contact details (email or phone).
  • If using phone contact method, ensure the phone number is in the correct international format.
  • Check that the action value is one of the allowed options (SIGN, APPROVE, SIGN_AS_A_WITNESS, RECOGNIZE).
  • If delivery method is required (phone contact), ensure it is set to either WhatsApp or SMS.
  • Common errors include invalid UUIDs for document or signatory, missing required fields, or API authentication failures. Verify credentials and input data.

Links

Discussion