Request unknown participant edition

You may not know the identity of the signer upon the transaction creation. Therefore, you may add an unknown participant to your transaction and assign him/her an editor. The assigned editor needs then to fill the unknown participant requested information (email, full name, phone number).

An unknown participant is identified by his/her designation and a description. The designation is a way to temporarily tag the unknown participant until the editor fills his/her information.

Create a signature/visa field on the document

To create a field, send a request to POST /v1/transactions/{transaction_id}/documents/{document_id}/fields and pass the type argument:

curl
https://api.universign.com/v1/transactions/tx_AWo949MOq0JE/documents/doc_wWz6/fields \
-d type=signature

You are returned a field ID in the API response:

{
    "id": "fld_a998",
    "type": "signature",
    "built_in": false,
    "consents": [],
    "updatable": true,
    "deletable": true
}

Assign an unknown participant to a field

To assign an unknown participant to a field, send a request to POST /v1/transactions/{transaction_id}/signatures and pass the field ID and the unknown participant temporary ID (preceeded by $) in the request arguments:

curl 
https://api.universign.com/v1/transactions/tx_AWo949MOq0JE/signatures \
-d signer=$UnknownParticipant \
-d field=fld_a998

The unknown participant temporary ID is limited to 250 characters.

Update an unknown participant

You can add a description and set optional parameters to the unknown participant, send a request to POST /v1/transactions/{transaction_id}/participants and pass the unknown participant temporary ID (preceeded by $) as the email in the request arguments:

curl
https://api.universign.com/v1/transactions/tx_AWo949MOq0JE/participants \
-d email=$UnknownParticipant \
-d designation=New employee \
-d description=The editor must add the new employee's email address. \
-d request_full_name=true \
-d request_phone_name=false

The unknown participant description is limited to 250 characters.

If the request_full_name parameter is set to true, the editor needs to fill the unknown participant full name. If the request_phone_number parameter is set to true, the editor needs to fill the unknown participant phone number.

Assign an editor to the unknown participant

To assign an editor to the unknown participant, send a request to POST /v1/transactions/{transaction_id}/editions and pass the editor and recipient arguments:

curl 
https://api.universign.com/v1/transactions/tx_AWo949MOq0JE/editors \
-d [email protected] \
-d recipient=$UnknownParticipant

Note that the editor can also be known or unknown. However, you need to have at least one known editor to complete the transaction process. If a transaction contains an unknown participant with no assigned known coeditor, it will be stalled as soon as the unknown participant action is ready to be performed. The API returns a stall_reason=unknown_editor.

If the editor refuses to perform his action, the transaction will be stalled and the API returns a stall_reason=edition_refusal.

Use case: Full Transaction Request with an unknown participant

Request example

{
  "autostart": true,
  "name": "Full transaction request with unknow participant",
  "language": "en",
    "duration": 15500,
  "signatures" : [ {
    "field" : "field_id_1",
    "signer" : "$UnknownParticipant"
  } ],
  "editions" : [ {
    "editor" : "[email protected]",
    "recipient" : ["$UnknownParticipant"]
  } ],
"participants" : [{
    "email" : "$UnknownParticipant",
    "schedule" : [0]
  },
  {
    "email" : "$UnknownParticipant",
    "schedule" : [0]
  }],
  "documents" : [{
    "name" : "MyDoc",
    "id" : "MyDocID",
    "fields" : [
        {
      "id" : "field_id_1",
      "name" : "field1",
      "page" : 1,
      "x" : 200,
      "y" : 400
    }],
    "content" : "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L0xhc3RDaGFyIDQKL1dpZHRoc1s3NTAgNzIyIDIyMiAyNzcgMjc3IF0KL0ZvbnREZXNjcmlwdG9yIDcgMCBSCi9Ub1VuaWNvZGUgOCAwIFIKPj4KZW5kb2JqCgoxMCAwIG9iago8PC9GMSA5IDAgUgo+PgplbmRvYmoKCjExIDAgb2JqCjw8L0ZvbnQgMTAgMCBSCi9Qcm9jU2V0Wy9QREYvVGV4dF0KPj4KZW5kb2JqCgoxIDAgb2JqCjw8L1R5cGUvUGFnZS9QYXJlbnQgNCAwIFIvUmVzb3VyY2VzIDExIDAgUi9NZWRpYUJveFswIDAgNTk1LjI3NTU5MDU1MTE4MSA4NDEuODg5NzYzNzc5NTI4XS9Hcm91cDw8L1MvVHJhbnNwYXJlbmN5L0NTL0RldmljZVJHQi9JIHRydWU+Pi9Db250ZW50cyAyIDAgUj4+CmVuZG9iagoKMTIgMCBvYmoKPDwvQ291bnQgMS9GaXJzdCAxMyAwIFIvTGFzdCAxMyAwIFIKPj4KZW5kb2JqCgoxMyAwIG9iago8PC9Db3VudCAwL1RpdGxlPEZFRkYwMDUwMDA2MTAwNjcwMDY1MDAyMDAwMzE+Ci9EZXN0WzEgMCBSL1hZWiAwIDg0MS44ODkgMF0vUGFyZW50IDEyIDAgUj4+CmVuZG9iagoKNCAwIG9iago8PC9UeXBlL1BhZ2VzCi9SZXNvdXJjZXMgMTEgMCBSCi9NZWRpYUJveFsgMCAwIDU5NSA4NDEgXQovS2lkc1sgMSAwIFIgXQovQ291bnQgMT4+CmVuZG9iagoKMTQgMCBvYmoKPDwvVHlwZS9DYXRhbG9nL1BhZ2VzIDQgMCBSCi9PcGVuQWN0aW9uWzEgMCBSIC9YWVogbnVsbCBudWxsIDBdCi9PdXRsaW5lcyAxMiAwIFIKPj4KZW5kb2JqCgoxNSAwIG9iago8PC9DcmVhdG9yPEZFRkYwMDQ0MDA3MjAwNjEwMDc3PgovUHJvZHVjZXI8RkVGRjAwNEMwMDY5MDA2MjAwNzIwMDY1MDA0RjAwNjYwMDY2MDA2OTAwNjMwMDY1MDAyMDAwMzYwMDJFMDAzND4KL0NyZWF0aW9uRGF0ZShEOjIwMjAxMTAzMDkzNDAxKzAxJzAwJyk+PgplbmRvYmoKCnhyZWYKMCAxNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDU1NzkgMDAwMDAgbiAKMDAwMDAwMDAxOSAwMDAwMCBuIAowMDAwMDAwMjIzIDAwMDAwIG4gCjAwMDAwMDU5MTMgMDAwMDAgbiAKMDAwMDAwMDI0MyAwMDAwMCBuIAowMDAwMDA0NzkzIDAwMDAwIG4gCjAwMDAwMDQ4MTQgMDAwMDAgbiAKMDAwMDAwNTAwOCAwMDAwMCBuIAowMDAwMDA1MzE4IDAwMDAwIG4gCjAwMDAwMDU0OTIgMDAwMDAgbiAKMDAwMDAwNTUyNCAwMDAwMCBuIAowMDAwMDA1NzQ4IDAwMDAwIG4gCjAwMDAwMDU4MDQgMDAwMDAgbiAKMDAwMDAwNjAxMiAwMDAwMCBuIAowMDAwMDA2MTEzIDAwMDAwIG4gCnRyYWlsZXIKPDwvU2l6ZSAxNi9Sb290IDE0IDAgUgovSW5mbyAxNSAwIFIKL0lEIFsgPDgyNkY1QzhGRDlBNzRCMkM0MzNFODAzN0I0RUI1MkY0Pgo8ODI2RjVDOEZEOUE3NEIyQzQzM0U4MDM3QjRFQjUyRjQ+IF0KL0RvY0NoZWNrc3VtIC8yMDBEREQ0NzMwMzI0Q0Q0QTJFMjlGRUNBODQxMjhBQwo+PgpzdGFydHhyZWYKNjI4MAolJUVPRgo="
  } ]
}

Response example

{
  "object" : "transaction",
  "id" : "tx_Ao9EZ1087nVL",
  "folder_id" : "fol_DGX2qbq6yGmm",
  "created_at" : "2025-07-01T09:09:42.014Z",
  "started_at" : "2025-07-01T09:09:42.227Z",
  "expires_at" : "2025-07-12T03:29:42.227Z",
  "name" : "Full transaction request with unknow participant",
  "folder_name" : "Default folder",
  "stalled" : false,
  "language" : "en",
  "creator" : {
    "workspace_name" : "DemoWS",
    "api_key_name" : "TestAPI"
  },
  "state" : "started",
  "participants" : [ {
    "email" : "$UnknownParticipant",
    "phone_number_type" : "suggestion",
    "request_phone_number" : false,
    "min_signature_level" : "level1",
    "schedule" : [ 0 ],
    "ongoing_conversation" : false,
    "has_unread_message" : false,
    "state" : "open",
    "request_full_name" : false,
    "full_name_type" : "suggestion",
    "waiting_period" : 0
  }, {
    "email" : "[email protected]",
    "phone_number_type" : "suggestion",
    "min_signature_level" : "level1",
    "schedule" : [ ],
    "ongoing_conversation" : false,
    "has_unread_message" : false,
    "state" : "open",
    "full_name_type" : "suggestion",
    "waiting_period" : 0
  } ],
  "watchers" : [ ],
  "sealers" : [ ],
  "documents" : [ {
    "id" : "doc_64b1",
    "name" : "MyDoc",
    "editable" : true,
    "updatable" : true,
    "deletable" : false,
    "fields" : [ {
      "id" : "fld_Z81V",
      "name" : "field1",
      "position" : {
        "page" : 1,
        "x" : 200,
        "y" : 400,
        "width" : 200,
        "height" : 50
      },
      "type" : "signature",
      "built_in" : false,
      "consents" : [ ],
      "optional_consents" : [ ],
      "updatable" : true,
      "deletable" : false
    } ],
    "big_file" : false,
    "available" : true
  } ],
  "instructions" : {
    "signatures" : [ {
      "signer" : "$UnknownParticipant",
      "field" : "fld_Z81V"
    } ],
    "reviews" : [ ],
    "captures" : [ ],
    "sequencing" : [ ],
    "editions" : [ {
      "editor" : "[email protected]",
      "recipient" : "$UnknownParticipant"
    } ]
  },
  "actions" : [ {
    "id" : "act_5X5z25K9WBOzB",
    "actor" : "[email protected]",
    "state" : "open",
    "url" : "https://apps.universign.com/npds/act_5X5z25K9WBOzB",
    "tasks" : [ {
      "type" : "edition",
      "state" : "todo",
      "editor" : "[email protected]",
      "recipient" : "$UnknownParticipant"
    } ],
    "stalled" : false
  }, {
    "id" : "act_nvqGWEbZgXeEY",
    "actor" : "$UnknownParticipant",
    "state" : "waiting",
    "url" : "https://apps.universign.com/npds/act_nvqGWEbZgXeEY",
    "tasks" : [ {
      "type" : "signature",
      "state" : "todo",
      "field" : "fld_Z81V"
    } ],
    "stalled" : false
  } ],
  "metadata" : { },
  "progress_value" : 0,
  "ongoing_conversation" : false,
  "has_unread_message" : false,
  "origin" : "API",
  "carbon_copies" : [ ],
  "collected" : [ ],
  "uploads" : [ ],
  "max_expiry" : "180_days",
  "issuing_entity" : {
    "id" : "iss_aX0wDPD86DlQ",
    "name" : "DemoWS",
    "lock_sender_name_display" : false
  },
  "private" : true
}

Request document review
Set participant name
Developer tools
Guides
Services
API reference