Cria uma transação

Cria UMA transação, sem recorrência, na hora (sem preview). Para lotes ou recorrências use POST /api/v1/transactions/batch. A conta precisa existir no workspace (nome exato de GET /api/v1/accounts); a categoria é criada se não existir. Consome 1 da cota mensal de transações.

post/api/v1/transactions

Request

Base URL: https://snabber.com.br
URL: https://snabber.com.br/api/v1/transactions
Auth: HTTP bearer

Query parameters

workspace_idinteger

Workspace a consultar, entre os autorizados para esta chave (ver GET /api/v1/workspaces). Se omitido, usa o workspace padrão da chave. Um id fora do conjunto autorizado resulta em 400 INVALID_WORKSPACE. Só é possível autorizar (em /integrations) um workspace do qual o dono da chave já é membro — para incluir dados de um workspace de outra pessoa, ela precisa primeiro compartilhar esse workspace com você (convite em /workspaces), não basta saber o id.

Headers

Idempotency-Keystring

Opcional. Repetir a requisição com a mesma chave (por 24h) devolve o resultado da primeira em vez de gravar de novo.

Request body

datestring date required

descriptionstring required

amountnumber required

Negativo = despesa; positivo = receita

categorystring required

accountstring required

Nome exato de uma conta do workspace

commentstring

paidboolean

Padrão: true até hoje, false para datas futuras

Response

Criada

statusstring

replayedboolean

true quando veio de um Idempotency-Key já usado

undo_idinteger

countinteger

transaction_idsinteger[]

quota_remaininginteger

Example response

{
  "status": "done"
}

Changes

No recorded changes to this operation across all 1 revision of this API.