> For the complete documentation index, see [llms.txt](https://docs.cange.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cange.me/api/cadastros/criar-um-registro.md).

# Criar um registro

Os registros no Cange são fundamentais para armazenar dados essenciais dos seus clientes, fornecedores, produtos, entre outros, possibilitando um gerenciamento detalhado e organizado. Com a flexibilidade para criar campos customizados, você pode garantir que a informação armazenada atenda precisamente às necessidades específicas do seu negócio.

Utilizar a API do Cange para criar registros oferece uma maneira altamente eficiente e automatizada de inserir, atualizar e gerir esses dados diretamente a partir das suas aplicações ou sistemas. Isso não só simplifica o processo, mas também melhora a produtividade e garante a integridade dos processos, assegurando que todos os dados cruciais sejam geridos de forma integrada e precisa.

Para criar um registro através da API, você precisará ter um token de acesso. Se ainda não possui o seu token, consulte nosso guia abaixo sobre como obter o token de autenticação.

{% content-ref url="/pages/9WZ3PW4K1WSS8OpsOrjm" %}
[Autenticação](/api/autenticacao.md)
{% endcontent-ref %}

Como os cadastros no Cange possuem campos dinâmicos, simplificamos o processo para você. Na tela de configuração dos campos, oferecemos uma opção prática para copiar o objeto do body da requisição completa. Basta abrir a tela de edição dos campos e, abaixo da pré-visualização do formulário, você encontrará um contêiner com a informação "Objeto API". Copie esse objeto e use-o como base para montar sua solicitação de criação de um registro, garantindo que todos os campos dinâmicos sejam corretamente incluídos.

<figure><img src="/files/1F5ad0QqWW0tqgJD6OnC" alt=""><figcaption></figcaption></figure>

## Realizando a chamada para criação do cartão

```http
https://api.cange.me/form/new-answer
```

<mark style="color:green;">`POST`</mark> `/form/new-answer`

Endpoint com o objetivo de criar um novo cartão dentro de um fluxo

**Headers**

| Name          | Value                      |
| ------------- | -------------------------- |
| Content-Type  | `application/json`         |
| Origin        | `https://app.cange.me`     |
| Authorization | `Bearer <token de acesso>` |

**Body**

| Name          | Type   | Description                                                                                                       |
| ------------- | ------ | ----------------------------------------------------------------------------------------------------------------- |
| `id_form`     | number | Código identificador do formulário                                                                                |
| `origin`      | string | Identificação do local que está partindo a solicitação                                                            |
| `values`      | object | Objeto com os campos do formulário e seu valor para inserção (Este objeto pode ser copiado na tela do formulário) |
| `register_id` | number | Código identificador do cadastro                                                                                  |

```
{
  "id_form": 3092,
  "origin": "/NomeDaSuaApi",
  "values": {
    "a4adaca0011489add4c4397ffdf8a434d7af59ee": "ReplaceByYourValue",
  },
  "register_id": 196
}
```

**Response**

{% tabs %}
{% tab title="200" %}

```json
[
   {
      "form_id":3092,
      "user_id_creator":230,
      "dt_created":"2024-09-06T14:46:16.000Z",
      "company_id":215,
      "origin":"/NomeDaSuaApi",
      "register_id":196,
      "id_form_answer":379412,
      "dt_deleted":null,
      "form_answer_fields":[
         {
            "form_answer_id":379412,
            "field_id":8153,
            "index":0,
            "value":"ReplaceByYourValue",
            "dt_created":"2024-09-06T14:46:16.000Z",
            "dt_last_update":"2024-09-06T14:46:16.000Z",
            "id_form_answer_field":2403205,
            "dt_deleted":null
         }
      ]
   }
]
```

{% endtab %}
{% endtabs %}