Skip to main content
POST
/
billing-thresholds
Criar Limite de Faturamento
curl --request POST \
  --url https://api.example.com/billing-thresholds \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "value": 123,
  "currency": "<string>"
}
'
{
  "billingThresholdId": "019525fd-a068-7e7c-d4f0-6a8b0c2e4f6c",
  "name": "Premium",
  "description": "Premium threshold",
  "value": 50000,
  "currency": "BRL",
  "status": "ACTIVE",
  "createdBy": "019525fd-56a8-7db4-8c3e-2a1b4d6f8e0c",
  "createdAt": "2026-03-25T14:00:00.000Z",
  "updatedBy": "019525fd-56a8-7db4-8c3e-2a1b4d6f8e0c",
  "updatedAt": "2026-03-25T14:00:00.000Z"
}
Requer permissao billing_threshold:write.

​
Headers

​
Authorization
string
required
Bearer token.

​
Corpo da Requisicao

​
name
string
required
Name. Max 255 caracteres.
​
description
string
required
Description.
​
value
integer
required
Valor do limite em centavos. Must be positive.
​
currency
string
required
Um de: USD, BRL, EUR.

​
Resposta

​
billingThresholdId
string
ID do limite de faturamento.
​
name
string
Nome do limite.
​
description
string
Descricao do limite.
​
value
integer
Valor do limite em centavos.
​
currency
string
Codigo da moeda.
​
status
string
Status do limite.
​
createdBy
string
ID do usuario que criou o limite.
​
createdAt
string
Timestamp de criacao.
​
updatedBy
string
ID do usuario que atualizou o limite por ultimo.
​
updatedAt
string
Timestamp da ultima atualizacao.
{
  "billingThresholdId": "019525fd-a068-7e7c-d4f0-6a8b0c2e4f6c",
  "name": "Premium",
  "description": "Premium threshold",
  "value": 50000,
  "currency": "BRL",
  "status": "ACTIVE",
  "createdBy": "019525fd-56a8-7db4-8c3e-2a1b4d6f8e0c",
  "createdAt": "2026-03-25T14:00:00.000Z",
  "updatedBy": "019525fd-56a8-7db4-8c3e-2a1b4d6f8e0c",
  "updatedAt": "2026-03-25T14:00:00.000Z"
}

​
Exemplos de Codigo

curl -X POST https://api.awsales.io/admin/billing-thresholds \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Standard Threshold",
  "description": "Default billing threshold",
  "value": 100000,
  "currency": "BRL"
}'

​
Codigos de Erro

StatusCodigoDescricao
400validation_errorEntrada invalida ou campos obrigatorios ausentes
401unauthorizedAutenticacao ausente ou invalida
403forbiddenPermissoes insuficientes
422billing_threshold.currency_not_compatibleBilling threshold currency is not compatible
500internal_server_errorOcorreu um erro inesperado