> For the complete documentation index, see [llms.txt](https://apidocs.cloudinvoice.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.cloudinvoice.net/documentacao-api/concelhos/create.md).

# Create

## Criar Concelho

## Cria um novo concelho.

<mark style="color:green;">`POST`</mark> `https://api.cloudinvoice.net/localities/new/`

#### Request Body

| Name                                           | Type    | Description                                                                                                            |
| ---------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------- |
| code<mark style="color:red;">\*</mark>         | string  | Código do Concelho.                                                                                                    |
| description<mark style="color:red;">\*</mark>  | string  | Descrição do Distrito                                                                                                  |
| district\_id<mark style="color:red;">\*</mark> | integer | <p>ID do Distrito</p><p><br>Consulte a tabela <a href="/pages/Oy0G8bxbN2ykl7r4A5Od">Distritos</a> para saber mais.</p> |
| zip\_code                                      | string  | Código Postal                                                                                                          |

{% tabs %}
{% tab title="Exemplo de Pedido" %}

```shell
curl -X POST https://api.cloudinvoice.net/localities/new/
    -d '{
        "code": "C1",
        "description": "Concelho #1",
        "district_id": 8
    }'
```

{% endtab %}

{% tab title="Exemplo de Resposta" %}

```json
{
    "id": 311,
    "code": "C1",
    "description": "Concelho #1",
    "zip_code": "",
    "district_id": 8,
    "district": {
        "code": "08",
        "description": "Faro"
    }
}
```

{% endtab %}
{% endtabs %}

Para ver exemplos de pedidos nas várias linguagens, consulte a página[ Exemplos de Pedidos.](/introducao/exemplos-de-pedidos.md)