---
title: "Criar lembrete de consumo no contrato"
method: POST
path: "/contracts/{contract_id}/consumption-reminders"
tags: ["Contratos"]
---

# Criar lembrete de consumo no contrato

`POST /contracts/{contract_id}/consumption-reminders`

## Request

- Base URL: `https://api.tiflux.com/api/v2`
- URL: `https://api.tiflux.com/api/v2/contracts/{contract_id}/consumption-reminders`
- Auth: HTTP bearer

Cria um lembrete de consumo no contrato. Quando o consumo do ciclo atinge uma das porcentagens, os e-mails do lembrete recebem o aviso.

**Regras e validações:**

* Só contratos de consumo: Crédito, Horas, Limite de atendimento e Horas cumulativas. O Crédito Compartilhado usa `POST /contract-groups/{contract_group_id}/consumption-reminders`

* Informe ao menos uma porcentagem ou um e-mail. Um lembrete só avisa quando tem as duas coisas

* Porcentagens inteiras de 1 a 999, sem repetir, até 10 por lembrete. Acima de 100% avisa o consumo excedente

* Até 10 lembretes por contrato

* `shifts_only` e `contract_and_shifts` só em Horas, Limite de atendimento e Horas cumulativas

* Sem aviso retroativo: as porcentagens que o consumo do ciclo atual já passou só avisam no próximo ciclo

## Request body

- object: Informe ao menos uma porcentagem ou um e-mail. Sem `alert_scope`, o lembrete avisa o consumo do contrato (`contract_only`)
  - `percentages` integer[]: (%) Porcentagens de consumo que disparam o aviso: inteiros de 1 a 999, sem repetir, até 10. Acima de 100% avisa o consumo excedente
  - `emails` string[]: E-mails que recebem o aviso
  - `alert_scope` 'contract_only' | 'shifts_only' | 'contract_and_shifts': Consumo avisado: `contract_only` (contrato), `shifts_only` (deslocamentos) ou `contract_and_shifts` (os dois). Deslocamentos só valem para Horas, Limite de atendimento e Horas cumulativas

## Response `201`

Lembrete criado

- object
  - `id` number, required: Identificador do lembrete
  - `percentages` number[], required: (%) Porcentagens de consumo que disparam o aviso
  - `emails` string[], required: E-mails que recebem o aviso
  - `alert_scope` 'contract_only' | 'shifts_only' | 'contract_and_shifts', required: Consumo avisado: `contract_only` (contrato), `shifts_only` (deslocamentos) ou `contract_and_shifts` (os dois). Deslocamentos só valem para Horas, Limite de atendimento e Horas cumulativas

## Other responses

- `400`: Atributo desconhecido
- `403`: ### **Problemas com permissão** Essa resposta significa que o seu usuário está autenticado corretamente, porém, não possui a permissão ou licença necessária para acessar essa rota
- `422`: Erro de validação

## Changes

- **2026-11-06** `2936ac99a76d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tiflux/apis/tiflux-official-api/changes/contracts/:contract_id/consumption-reminders/post.md)

---

[API](https://skmtc.dev/tiflux/apis/tiflux-official-api.md) - [All operations](https://skmtc.dev/tiflux/apis/tiflux-official-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tiflux/apis/tiflux-official-api/revisions/2936ac99a76d?raw)