# Adicionar Signatário

Para adicionar um signatário à um documento, você pode utilizar a seguinte *mutation*.

**Definição da Mutation:**

Aqui está a definição da *mutation* para adicionar um signatário:

```graphql
mutation(
  $document_id: UUID!,
  $signer: SignerInput
) {
  createSigner(
    document_id: $document_id 
    signer: $signer
  ) {
    public_id
    name
    email
    delivery_method
    action { name }
    link {
      id
      short_link 
    }
    created_at
  }
}
```

**Parâmetros:**

* `document_id`: O identificador único do documento ao qual você deseja adicionar um signatário.
* `signer`: Contém os detalhes do signatário que está sendo adicionado. Este objeto requer atenção especial para os campos obrigatórios e opcionais, conforme definido em nossa especificação de *SignerInput*.

Após, é necessário atribuir os valores das variáveis declaradas na *mutation*, em um JSON :

```json
{
  "document_id": "ID_DO_DOCUMENTO",
    "signer": { 
      "email": "troque-esse-email-que-tambem-e-publico@tuamaeaquelaursa.com",
      "action": "SIGN"
    }
}
```

Lembre-se de substituir os valores, passando o ID do documento e informações de signatário, que são os mesmos mencionados em: [Criando um Documento](/api/2/mutations/criando-um-documento.md).

#### Resposta esperada:

A resposta incluirá os detalhes sobre o signatário criado mencionados na definição da *mutation*. Aqui está um exemplo de resposta que você pode esperar:

```json
{
  "data": {
    "createSigner": {
      "public_id": "434fcd4c6d0c11eea3c542010a2b60c6",
      "name": null,
      "email": "troque-esse-email-que-tambem-e-publico@tuamaeaquelaursa.com",
      "delivery_method": "DELIVERY_METHOD_EMAIL",
      "action": {
        "name": "SIGN"
      },
      "link": null,
      "created_at": "2023-10-17T16:43:13.000000Z"
    }
  }
}
```

O campo *link informará o link* de assinatura para o signatário, caso o mesmo tenha sido adicionado usando o parâmetro `"delivery_method": "DELIVERY_METHOD_LINK"`.

{% hint style="info" %}
Você pode conferir o que é cada um desses parâmetros direto na documentação completa da API GraphQL, no menu Docs do [Altair](https://altair.autentique.com.br). Se você não sabe como fazer isso, confira o nosso tutorial em [Usando o Altair](/api/2/integracao/altair.md).
{% endhint %}

{% hint style="info" %}
Se o Altair não te ajuda para integrar com a API, confira alguns exemplos de como fazer essas requisições de outra forma: <https://graphql.org/graphql-js/graphql-clients/>
{% endhint %}


---

# 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.autentique.com.br/api/2/mutations/adicionar-signatario.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.