---
updatedAt: 2025-06-05T22:19:08.000Z
agentTools:
  projectIndex: https://api.fracttal.com/v3-pt/llms.txt
---

# Criar contas de usuário

As contas de usuário podem ser criadas por meio desse serviço da Web. Esse endpoint só pode ser executado por quem tem permissão para realizar a criação de contas.

## Parâmetros do Body

As informações a seguir devem ser enviadas no corpo da solicitação.

<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Parâmetros
      </th>

      <th style={{ textAlign: "left" }}>
        Tipo
      </th>

      <th style={{ textAlign: "left" }}>
        Obrigatório
      </th>

      <th style={{ textAlign: "left" }}>
        Descrição
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        <code>email</code>
      </td>

      <td style={{ textAlign: "left" }}>
        *Texto*
      </td>

      <td style={{ textAlign: "left" }}>
        Opcional
      </td>

      <td style={{ textAlign: "left" }}>
        E-mail com o qual o usuário se registrará. Caso não seja enviado, será atribuído o e-mail registrado pelo usuário na Fracttal como um recurso humano ou como um contato de terceiros.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        <code>id\_profile</code>
      </td>

      <td style={{ textAlign: "left" }}>
        *Inteiro*
      </td>

      <td style={{ textAlign: "left" }}>
        Sim
      </td>

      <td style={{ textAlign: "left" }}>
        Número do tipo de usuário a ser criado, 3 devem ser enviados.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        <code>enable\_notifications</code>
      </td>

      <td style={{ textAlign: "left" }}>
        *Booleano*
      </td>

      <td style={{ textAlign: "left" }}>
        Opcional
      </td>

      <td style={{ textAlign: "left" }}>
        Valor para ativar as notificações da Fracttal, o padrão é true
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        <code>only\_sso</code>
      </td>

      <td style={{ textAlign: "left" }}>
        *Booleano*
      </td>

      <td style={{ textAlign: "left" }}>
        Opcional
      </td>

      <td style={{ textAlign: "left" }}>
        Valor para ativar somente a autenticação de logon único (SSO); o padrão é false
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        <code>user\_type</code>
      </td>

      <td style={{ textAlign: "left" }}>
        *Texto*
      </td>

      <td style={{ textAlign: "left" }}>
        Sim
      </td>

      <td style={{ textAlign: "left" }}>
        Um dos seguintes valores deve ser enviado:\
        HUMAN\_RESOURCES (para associar a conta a um recurso humano)\
        THIRD\_PARTIES (para associar a conta a um terceiro ou fornecedor)
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        <code>personnel\_code</code>
      </td>

      <td style={{ textAlign: "left" }}>
        *Texto*
      </td>

      <td style={{ textAlign: "left" }}>
        Opcional
      </td>

      <td style={{ textAlign: "left" }}>
        É enviado o código do recurso humano registrado na Fracttal, que [pode ser obtido aqui ](https://api.fracttal.com/reference/consulta-de-recursos-humanos) (field *code*).\
        Esse campo é obrigatório quando type\_user = HUMAN\_RESOURCES.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        <code>third\_party\_code</code>
      </td>

      <td style={{ textAlign: "left" }}>
        *Texto*
      </td>

      <td style={{ textAlign: "left" }}>
        Opcional
      </td>

      <td style={{ textAlign: "left" }}>
        É enviado o código do terceiro registrado na Fracttal, que [pode ser obtido aqui ](https://api.fracttal.com/reference/consulta-de-terceros) (field *code*).\
        Esse campo é obrigatório quando type\_user = THIRD\_PARTIES.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        <code>name\_contact</code>
      </td>

      <td style={{ textAlign: "left" }}>
        *Texto*
      </td>

      <td style={{ textAlign: "left" }}>
        Opcional
      </td>

      <td style={{ textAlign: "left" }}>
        É enviado o nome do contato associado ao terceiro a ser relacionado, que [pode ser obtido aqui ](https://api.fracttal.com/reference/consulta-de-terceros) (campo *name*).\
        Esse campo é obrigatório quando type\_user = THIRD\_PARTIES..
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        <code>user\_code</code>
      </td>

      <td style={{ textAlign: "left" }}>
        *Texto*
      </td>

      <td style={{ textAlign: "left" }}>
        Sim
      </td>

      <td style={{ textAlign: "left" }}>
        Código do recurso humano que criará a conta na Fracttal.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        <code>location\_code</code>
      </td>

      <td style={{ textAlign: "left" }}>
        *Texto*
      </td>

      <td style={{ textAlign: "left" }}>
        Opcional
      </td>

      <td style={{ textAlign: "left" }}>
        Código de localização da conta de usuário.
      </td>
    </tr>
  </tbody>
</Table>

## Parâmetros adicionais do órgão ao criar Recursos Humanos

<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th>
        Parâmetro
      </th>

      <th>
        Tipo
      </th>

      <th>
        Obrigatório
      </th>

      <th>
        Descrição
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <code>first\_name</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Sim
      </td>

      <td>
        Nomes do recurso humano. Se o recurso humano não existir ao enviar esse campo, a API o criará. Esse campo só deve ser usado quando type\_user = HUMAN\_RESOURCES
      </td>
    </tr>

    <tr>
      <td>
        <code>last\_name</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Sobrenome do recurso humano
      </td>
    </tr>

    <tr>
      <td>
        <code>human\_resource\_active</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Indica se o recurso está ativo ou não
      </td>
    </tr>

    <tr>
      <td>
        <code>code\_asset\_location</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Código do ativo do tipo de localização no qual o recurso humano estará localizado. (Pode ser obtido aqui)(

        [https://api.fracttal.com/reference/consultar-un-activo](https://api.fracttal.com/reference/consultar-un-activo)

        ) (campo 

        *code*

        )
      </td>
    </tr>

    <tr>
      <td>
        <code>group\_1</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Descrição da classificação 1
      </td>
    </tr>

    <tr>
      <td>
        <code>group\_2</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Descrição da classificação 2
      </td>
    </tr>

    <tr>
      <td>
        <code>address</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Endereço
      </td>
    </tr>

    <tr>
      <td>
        <code>city</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Cidade
      </td>
    </tr>

    <tr>
      <td>
        <code>state</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Estado
      </td>
    </tr>

    <tr>
      <td>
        <code>zip\_code</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Código postal
      </td>
    </tr>

    <tr>
      <td>
        <code>country</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        País
      </td>
    </tr>

    <tr>
      <td>
        <code>latitude</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Latitude
      </td>
    </tr>

    <tr>
      <td>
        <code>longitud</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Longuitude
      </td>
    </tr>

    <tr>
      <td>
        <code>telephone</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Telefone
      </td>
    </tr>

    <tr>
      <td>
        <code>telephone\_2</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Telefone 2.
      </td>
    </tr>

    <tr>
      <td>
        <code>sms</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Sms
      </td>
    </tr>

    <tr>
      <td>
        <code>id\_hourly\_rate</code>
      </td>

      <td>
        Inteiro
      </td>

      <td>
        Opcional
      </td>

      <td>
        Id da hora normal (não deve ser enviado se o campo 

        *description_hourly_rate*

         for enviado). 

        [Pode ser obtido aqui](https://api.fracttal.com/reference/valor-hora-ordinaria)

          (campo 

        *id*

        )
      </td>
    </tr>

    <tr>
      <td>
        <code>description\_hourly\_rate</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Descrição do horário normal (não deve ser enviado se o campo 

        *id_hourly_rate*

         for enviado). 

        [Disponível aqui](https://api.fracttal.com/reference/valor-hora-ordinaria)

          (campo 

        *description*

        )
      </td>
    </tr>
  </tbody>
</Table>

## Parâmetros adicionais do corpo quando um terceiro deve ser criado

<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th>
        Parâmetros
      </th>

      <th>
        Tipo
      </th>

      <th>
        Obrigatório
      </th>

      <th>
        Descrição
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <code>third\_party\_name</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Sim
      </td>

      <td>
        Nome do terceiro
      </td>
    </tr>

    <tr>
      <td>
        <code>third\_party\_active</code>
      </td>

      <td>
        *Booleano*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Indica se o recurso estará ativo ou não. O padrão é true
      </td>
    </tr>

    <tr>
      <td>
        <code>code\_parent\_location</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Código do ativo do tipo de localização no qual o recurso humano estará localizado. (Pode ser obtido aqui)([https://api.fracttal.com/reference/consultar-un-activo](https://api.fracttal.com/reference/consultar-un-activo)) (campo *code*)
      </td>
    </tr>

    <tr>
      <td>
        <code>group\_1</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Descrição da classificação 1
      </td>
    </tr>

    <tr>
      <td>
        <code>group\_2</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Descrição da classificação 2
      </td>
    </tr>

    <tr>
      <td>
        <code>address</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Endereço
      </td>
    </tr>

    <tr>
      <td>
        <code>city</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Cidade
      </td>
    </tr>

    <tr>
      <td>
        <code>state</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Estado
      </td>
    </tr>

    <tr>
      <td>
        <code>zip\_code</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Código Postal
      </td>
    </tr>

    <tr>
      <td>
        <code>country</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        País
      </td>
    </tr>

    <tr>
      <td>
        <code>latitude</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Latitude
      </td>
    </tr>

    <tr>
      <td>
        <code>longitud</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Longitude
      </td>
    </tr>

    <tr>
      <td>
        <code>telephone</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Telefone
      </td>
    </tr>

    <tr>
      <td>
        <code>telephone\_2</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Telefone 2
      </td>
    </tr>

    <tr>
      <td>
        <code>sms</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Sms
      </td>
    </tr>

    <tr>
      <td>
        <code>fax</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Fax
      </td>
    </tr>

    <tr>
      <td>
        <code>web\_page</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Página web
      </td>
    </tr>

    <tr>
      <td>
        <code>visible\_to\_all</code>
      </td>

      <td>
        *Booleano*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Indica se ele é visível para todos. O padrão é falso
      </td>
    </tr>

    <tr>
      <td>
        <code>id\_third\_party\_type</code>
      </td>

      <td>
        *Array de inteiros*
      </td>

      <td>
        Opcional
      </td>

      <td>
        1: Fornecedor de serviços (padrão)\
        2: Fabricante\
        3: Fornecedor\
        4: Cliente
      </td>
    </tr>

    <tr>
      <td>
        <code>movil</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Número de telefone celular do contato
      </td>
    </tr>

    <tr>
      <td>
        <code>skype</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Contato pelo Skype
      </td>
    </tr>

    <tr>
      <td>
        <code>linkedin</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Opcional
      </td>

      <td>
        Linkedin do contato
      </td>
    </tr>

    <tr>
      <td>
        <code>role</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Sim
      </td>

      <td>
        Função do contato
      </td>
    </tr>

    <tr>
      <td>
        <code>parties\_name</code>
      </td>

      <td>
        *Texto*
      </td>

      <td>
        Sim
      </td>

      <td>
        Título do terceiro
      </td>
    </tr>
  </tbody>
</Table>

## Parâmetros de saída

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Tipo
      </th>

      <th>
        Parámetro
      </th>

      <th>
        Descrição
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        *Inteiro*
      </td>

      <td>
        <code>id</code>
      </td>

      <td>
        ID da conta
      </td>
    </tr>

    <tr>
      <td>
        *Texto*
      </td>

      <td>
        <code>name</code>
      </td>

      <td>
        Nome do usuário
      </td>
    </tr>

    <tr>
      <td>
        *Texto*
      </td>

      <td>
        <code>email</code>
      </td>

      <td>
        Endereço de e-mail do usuário
      </td>
    </tr>

    <tr>
      <td>
        *Booleano*
      </td>

      <td>
        <code>active</code>
      </td>

      <td>
        Indica se o usuário está ativo ou não
      </td>
    </tr>

    <tr>
      <td>
        *Texto*
      </td>

      <td>
        <code>user\_type</code>
      </td>

      <td>
        Tipo de usuário:  

        HUMAN\_RESOURCES: Recursos Humanos\
        THIRD\_PARTIES: Terceiros
      </td>
    </tr>

    <tr>
      <td>
        *Booleano*
      </td>

      <td>
        <code>enable\_notifications</code>
      </td>

      <td>
        Indica se as notificações de fractal estão ativadas para o usuário.
      </td>
    </tr>

    <tr>
      <td>
        *Booleano*
      </td>

      <td>
        <code>only\_sso</code>
      </td>

      <td>
        Indica se você tem apenas autenticação de logon único (SSO).
      </td>
    </tr>
  </tbody>
</Table>

## Exemplo:

Solicitação: **(POST)<https://app.fracttal.com/api/accounts/>**

```json Body
{   
    "email": "demo@fracttal.com",
    "id_profile": 3,
    "enable_notifications": true,
    "only_sso": false,
    "user_type": "HUMAN_RESOURCES",
    "personnel_code": "456123489",
    "user_code": "25198772-2",
}
```
```json Body crear recurso humano
{   
    "email": "demo@fracttal.com",
    "id_profile": 3,
    "enable_notifications": true,
    "only_sso": false,
    "user_type": "HUMAN_RESOURCES",
    "personnel_code": "456123489",
    "user_code": "25198772-2",
    "first_name":"Nombre Persona",
    "last_name":"Apellido Persona"
}
```
```json Body crear tercero
{   
    "email": "demo@fracttal.com",
    "id_profile": 3,
    "enable_notifications": true,
    "only_sso": false,
    "user_type": "THIRD_PARTIES",
    "third_party_code": "456123489",
    "user_code": "2518772-1",
    "name_contact":"Nombre contacto",
    "third_party_name":"Nombre Tercero",
    "id_third_party_type":[1],
    "role":"Mecánico",
    "telephone":"234567",
    "movil":"300555555"
}
```
```json Response
{
    "success": true,
    "message": "200",
    "data": {
        "id": 72,
        "id_company": 69,
        "email": "demo@fracttal.com",
        "name":"Usuario solo solicitudes",
        "active": true,
        "enable_notifications": true,
        "only_sso": false,
        "id_contact": null,
        "id_third_paties": null,
        "id_human_resources": null
    },
    "total": 1
}
```

<HTMLBlock>{`
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Maven+Pro&display=swap" rel="stylesheet">
<link href='https://fonts.googleapis.com/css?family=Heebo' rel='stylesheet'>
<style>
      table {
      border-collapse: collapse;
      border-radius: 1em;
      overflow: hidden;
    }
    
    th,
    td {
      border: 1px solid #E5E5E5;
      padding: 1em;
    }


    body {
      margin: 1.5em;
    }

    .font{
font-size: 14px;
font-weight: 700;
line-height: 17px;
letter-spacing: 0em;
text-align: left;
    color: #4687F1;
      font-style: uppercase;
  }
    table thead {
      background: rgba(70, 135, 241, 0.1) !important;
      color: #4687F1 !important;
      font-size: 13px !important;
      line-height: 17px !important;
    }
  .type-get {
      background-color: #6bbd5b;
      color: white;
      font-size: .7rem;
      padding: .2rem;
      border-radius: .2rem;
      text-transform: uppercase;
      font-weight: bold;
  }
  
  .frame-full {
      width: 100%;
      height: 1000px;
      border-width: 0;
  }

  h1, h2, h3, h4, h5, h6 {
  	font-family: 'Heebo', sans-serif;
  }
  
  code {
  	max-height: 40vh!important;
  }
  
  hr.rounded {
    border-top: 5px solid black;
    border-radius: 5px;
  }
  
  #ReferencePlayground {
  	display: none;
  }
  .Reference-section {
  	display: none;
  }
</style>
`}</HTMLBlock>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "criar-contas-de-usuario",
    "version": "3-pt"
  },
  "servers": [
    {
      "url": "https://app.fracttal.com/api/accounts/"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/": {
      "post": {
        "summary": "Criar contas de usuário",
        "description": "",
        "operationId": "criar-contas-de-usuario",
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "text/plain": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```