# 3. Create Signer Process

The portal requests the creation of the PDF document batch signature process by sending the following message to the UAE PASS using the signature services API. This API call will create a signing process at UAE PASS end.

<mark style="color:green;">`POST`</mark> **`stg-id.uaepass.ae/trustedx-resources/esignsp/v2/signer_processes`**

HTTP/1.1

#### Headers

| Name                                            | Type   | Description                          |
| ----------------------------------------------- | ------ | ------------------------------------ |
| Authorization<mark style="color:red;">\*</mark> | string | Bearer \<token>                      |
| Cache-Control<mark style="color:red;">\*</mark> | string | no-cache                             |
| Postman-Token<mark style="color:red;">\*</mark> | string | 0cb4e517-8db9-473c-7b14-0ca2555bc199 |
| Content-Type<mark style="color:red;">\*</mark>  | string | application/json                     |

#### Response

{% tabs %}
{% tab title="201 If the request is successfully processed, UAE PASS creates the signature process for the document and responds to the document signature portal with the following HTTP message.
Location: <https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/signer_processes/sp_c4eed0a1f478f72454803695d53c4c52> Content-Type: application/json" %}

```
{
    "process_type": "urn:safelayer:eidas:processes:document:sign:esigp",
    "id": "hrcmc4pr78dt4s35jlbi4nmdrler4nn2",
    "self": "https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/signer_processes/hrcmc4pr78dt4s35jlbi4nmdrler4nn2",
    "tasks": {
        "pending": [
            {
                "type": "UserBrowserTask",
                "id": "dtvnbg6pbmaec4a35tlpnt1krs27hve1",
                "url": "https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/ui?signerProcessId=hrcmc4pr78dt4s35jlbi4nmdrler4nn2"
            }
        ]
    },
    "documents": [
        {
            "id": "c7mrogv8sqersqfj4sj7q21ucs1d3t4r",
            "url": "https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/documents/c7mrogv8sqersqfj4sj7q21ucs1d3t4r",
            "content": "https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/documents/c7mrogv8sqersqfj4sj7q21ucs1d3t4r/content"
        },
        {
            "id": "afa9gmord6dh6vhlvp1s533fs5fn8tui",
            "url": "https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/documents/afa9gmord6dh6vhlvp1s533fs5fn8tui",
            "content": "https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/documents/afa9gmord6dh6vhlvp1s533fs5fn8tui/content"
        }
    ]
}

```

{% endtab %}
{% endtabs %}

#### Request Body

```json
{
              "process_type": "urn:safelayer:eidas:processes:document:sign:esigp",
              "labels": [
                             [
                                           "digitalid",
                                           "server",
                                           "qualified"
                             ]
              ],
"documents": [
        {
            "id":"ieedah0mrjshgpblmt418l2m4rh8tlrd"
        },
        {
            "id":"g6do7ak05v3mod6i5sti3v33kdf0al9a"
        }
        ]
        ,

              "ui_locales": [
                             "en_US"
              ],
              "finish_callback_url": "http://localhost:8080/test",
              "views": {
                             "document_agreement": {
                                           "skip_server_id": "true"
                             }
              },
              "timestamp": {
                             "provider_id": "urn:uae:tws:generation:policy:digitalid"
              }
}

```

UAEPASS communicates with the signature portal, that successfully creates the signature process and that must redirects the user's browser to [https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/ui?signerProcessId=sp\_c4eed0a1f478f72454803695d53c4c5](https://qa-id.uaepass.ae/trustedx-resources/esignsp/v2/ui?signerProcessId=sp_c4eed0a1f478f72454803695d53c4c5) (tasks.pending.url) for this process to continue.&#x20;

It also communicates to the signature portal that obtain the signed document it must access [https://stg-id.uaepass.ae/trustedx-resources/esignsp/v2/documents/dc\_9ee0990055818516249f28558e1b256b/content](https://qa-id.uaepass.ae/trustedx-resources/esignsp/v2/documents/dc_9ee0990055818516249f28558e1b256b/content) (i.e., the URL resulting from concatenating /content to the URL specified in documents\[0].If signing the same document twice, make sure that unique value is passed for the name parameter in process type of request body as below:


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.uaepass.ae/feature-guides/signature-integration-guide/digital-signature-multiple-document/signing-guide/untitled/2.-creating-the-document-signature-process.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
