Criar grupo de contatos

POST

/api/contact-groups

Cria um grupo. O name precisa ser único na organização entre os grupos não
excluídos — repetir um nome existente retorna 400.

Retorna 200 (não 201); o id da resposta é o uuid do grupo.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/jsonNecessário

Exemplo

{
    "name": "Clientes VIP"
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://titov.com.br/api/contact-groups' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Clientes VIP"
}'

Respostas

🟢200OK

application/json

Operação concluída. O campo id é o uuid do contato, não o ID numérico interno.

Bodyapplication/json

Exemplo

{
    "statusCode": 200,
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "message": "Request processed successfully"
}

🟠400Requisição Inválida

🟠401Não Autorizado

🔴500Erro do Servidor

Modificado em 2026-07-17 11:51:13

Página anterior

Listar grupos de contatos

Próxima página

Atualizar grupo de contatos