---
title: "POST Create company"
method: POST
path: "/api/companies"
---

# POST Create company

`POST /api/companies`

Com este endpoint, você pode **criar uma subconta** e, a partir disso, **manipular a conta utilizando o seu respectivo token**.

Esse processo permite que você gerencie subcontas de forma independente dentro do sistema.

## Request body

- object
  - `name` string, required — Primeiro nome do administrador da empresa.
  - `last_name` string, required — Sobrenome do administrador da empresa (Limite de 80 caráctere).
  - `company_name` string, required — Nome da empresa cadastrada.
  - `email` string, required — E-mail da empresa e do administrador da conta (O e-mail da empresa pode ser alterado depois, o do admin não, Limite de 255 carácteres).
  - `phone` string, required — Telefone da empresa, somente números com DDD, caso seja um celular com WhatsApp, o mesmo será utilizado nas comunicações.
  - `company_brand` string, binary — Logo da empresa.
  - `company_icon` string, binary — Ícone da empresa.
  - `cnpj` string, required — CNPJ da empresa devidamente formatado ou apenas números.
  - `address` string, required — Endereço da empresa.
  - `password` string — Senha de acesso do usuário administrador da empresa, 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.
  - `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.
  - `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.
  - `mail_host` string — Host do seu provedor de e-mails.
  - `mail_from` string — Qual endereço de e-mail está enviando a mensagem.
  - `mail_username` string — Usuário de e-mail para autenticação (Na maioria dos casos é o mesmo do mail_from).
  - `mail_password` string — Senha do e-mail.
  - `mail_encryption` string — Tipo de autenticação, aceito apenas tsl ou ssl.
  - `mail_port` integer — Porta de saída do provedor, somente números.
  - `can_login` boolean — Preencha este campo com 1 se a empresa está autorizada a acessar o sistema, e com 0 se não está autorizada.
  - `payment_end` string — Formato d/m/Y. payment_end tem que ser maior que a data atual.
  - `plugzapi_instance` string — Instância do PlugZapi.
  - `plugzapi_token` string — Token do PlugZapi.
  - `plugzapi_account_token` string — Account token do PlugZapi.
  - `editablevalidate` integer — 1 - QR Code no topo do documento (Sem página final). <br><br> Ao solicitar a assinatura na última página, sem posicioná-la, a página final será sempre gerada automaticamente. <br><br> 2 - Sem QR Code no topo, apenas página no final. <br><br> 3 - Página final de validação e QR Code no cabeçalho (Criaremos páginas extras). <br><br> 4 - QR Code no rodapé do documento (Sem página final). <br><br> 5 - Página final de validação e QR Code no rodapé (Criaremos páginas extras). <br><br> 6 - QR Code (Texto) na lateral esquerda. <br><br> 7 - QR Code (Texto) na lateral direita. <br><br>
  - `unlimited` integer — Quando ativado (True), nenhum custom limit será aplicado a empresa.
  - `limits` object[] — Limites da empresa.
    - `type` 'disk' | 'users' | 'files' | 'signer', required — Tipo do limite.
    - `limit` integer, required — Limite total em número.
  - `webhook_header_name` string — Nome do header customizado que é enviado no envio dos webhook para a URI cadastrada.
  - `webhook_header_value` string — Valor do header customizado que é enviado no envio dos webhook para a URI cadastrada.
  - `reseller_login` boolean — Define se a empresa revendedora está autorizada a realizar login na subconta para fins de suporte. Quando habilitado (true), o administrador da revendedora poderá acessar a conta da parceira de forma ilimitada. Quando desabilitado (false), esse acesso é bloqueado.

## Response `200`

200

- object
  - `message` string — Mensagem de confirmação retornada pela API.
  - `token_type` string — Tipo do token de autenticação gerado.
  - `token` string — Token de autenticação do administrador da empresa recém-criada.
  - `company` object — Objeto principal contendo os dados da empresa criada.
    - `id` integer — Identificador único da empresa.
    - `name` string — Nome da empresa.
    - `email` string — E-mail da empresa.
    - `phone` string — Telefone da empresa.
    - `cnpj` string — CNPJ da empresa.
    - `address` string — Endereço da empresa.
    - `access` object — Objeto contendo as credenciais de acesso da empresa.
      - `token` string — Token de acesso da subconta para uso na API.
    - `cpf` string — CPF do administrador da empresa.

---

[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)