> For the complete documentation index, see [llms.txt](https://docs.autentique.com.br/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autentique.com.br/api/2/mutations/adicionar-signatario.md).

# 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 
    }
     verifications {
      type
      fallback_behavior
    }
    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@example.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@example.com",
      "delivery_method": "DELIVERY_METHOD_EMAIL",
      "action": {
        "name": "SIGN"
      },
      "link": null,
      "created_at": "2023-10-17T16:43:13.000000Z",
       "security_verifications": [
      {
        "type": "PF_FACIAL",
        "fallback_behavior": "DISABLE_FALLBACK"
      }
     ]
    }
  }
}
```

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 %}