POST /v2/counters/{counterId}/increment[/{amount}]

Increments an UpDown counter. The optional amount path segment sets the step size (must be ≥ 1, defaults to 1).

# Increment by 1
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" \
  https://developers.counttogether.app/v2/counters/018f5b54-9b11-7c33-b347-a2b4e2a6a111/increment

# Increment by 5
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" \
  https://developers.counttogether.app/v2/counters/018f5b54-9b11-7c33-b347-a2b4e2a6a111/increment/5

Response (200)

12455

The new numeric value is returned as a plain number.

Possible Errors

HTTP	Code	Reason
400	—	`amount` is ≤ 0
400	InvalidOperationForCounterType	Counter is not UpDown
400	GoalExceedingNotAllowed	Goal reached and exceeding is not allowed
401	—	Missing or invalid token
403	—	User not a member / lacks permission
404	NotFound	Counter not found

Realtime Integration

Successful increments emit a counterUpdated WebSocket notification.

Idempotency

Not idempotent — each POST applies the increment again.

21 April 2026