---
title: "POST Create customer"
method: POST
path: "/api/customers"
---

# POST Create customer

`POST /api/customers`

Com a criação de clientes é possível disponibilizar contas no ambiente visual para que os clientes da empresa assinem documentos logados e tenham acesso rápido aos seus documentos. <br><br> As contas para clientes são do modo "Read only", portanto não podem visualizar informações, criar pastas, enviar documentos nem fazer nenhuma ação no sistema além de assinar documentos para os quais recebeu uma solicitação de assinatura. <br><br> As principais vantagens para se criar uma conta de cliente são: <br><br> 1. Na solicitação de assinatura pelo front-end, você não precisará digitar os e-mails, basta selecionar na lista de clientes. <br><br> 2. Seu cliente não vai precisar procurar no e-mail links de documentos antigos que assinou, acessando a plataforma vai ver todos na pasta "Compartilhados comigo". <br><br> 3. Seu cliente não vai precisar criar a sua assinatura sempre que for assinar um documento, ele vai poder assinar logado com apenas 2 cliques. <br><br> Atenção! A criação de conta <b>NÃO É OBRIGATÓRIA</b> para assinar documentos, é possível solicitar assinaturas apenas pelo e-mail, a conta é um recurso que busca facilitar o dia a dia de clientes que assinam muitos documentos, portanto não é algo mandatório <br><br> <b>Os clientes ou "Customers" são os clientes da empresa que envia os documentos, para criar subcontas empresariais em implantações para terceiros verifique os endpoints "Companies"</b>

## Request body

- object
  - `name` string, required — Primeiro nome do cliente adicionado na plataforma.
  - `last_name` string, required — Sobrenome do cliente adicionado na plataforma.
  - `birth` string, date — Data de nascimento do cliente no formato ano-mês-dia. Exemplo: 1990-05-12.
  - `email` string, required — Endereço de e-mail do cliente adicionado na plataforma.
  - `phone` string, required — Número de telefone com o 9 do cliente, caso seja um WhatsApp, o mesmo será utilizado para envio de alertas e notificações, incluindo quando uma assinatura for solicitada ao mesmo.
  - `address` string, required — Endereço do seu cliente adicionado na plataforma.
  - `recive_email` string — Se o usuário vai receber e-mails do sistema, 0 = Não recebe nada, 1 = Recebe tudo, 2 = Recebe somente solicitações.
  - `recive_whatsapp` string — Se o usuário vai receber mensagens de WhatsApp do sistema, 0 = Não recebe nada, 1 = Recebe tudo, 2 = Recebe somente solicitações.
  - `cpf` string — CPF do cliente devidamente formatado ou apenas números.
  - `password` string — Senha do seu colaborador para cadastro, caso não seja fornecida o sistema irá gerar uma senha temporária e enviará para ele por e-mail, caso passe uma senha, o sistema não vai avisa-lo sobre a criação da conta e não vai enviar alertas para o mesmo.
  - `cert_file` string, binary — Arquivo do certificado digital PFX.
  - `cert_password` string — Senha do certificado para validação, caso passe o certificado a senha é obrigatória.

## Response `200`

200

- object
  - `data` object — Objeto principal contendo os dados do cliente criado.
    - `id` integer — Identificador único do cliente.
    - `name` string — Primeiro nome do cliente.
    - `last_name` string — Sobrenome do cliente.
    - `phone` string — Telefone do cliente.
    - `address` string — Endereço do cliente.
    - `email` string — E-mail do cliente.
  - `message` string — Mensagem de confirmação retornada pela API.

---

[API](https://skmtc.net/plugsign/apis/endpoints-manuais.md) · [All operations](https://skmtc.net/plugsign/apis/endpoints-manuais/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plugsign/endpoints-manuais/revisions/41e10c7c691b/schema)