Create a tax rate

This endpoint creates a new tax representing a customizable tax rate applicable to either the organization or a specific customer.

POST /taxes

cURL

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request POST "$LAGO_URL/api/v1/taxes" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
    "tax": {
      "name": "TVA",
      "code": "french_standard_vat",
      "rate": "20.0",
      "description": "French standard VAT",
      "applied_to_organization": false
    }
  }'

200

{
  "tax": {
    "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
    "name": "TVA",
    "code": "french_standard_vat",
    "rate": 20,
    "applied_to_organization": true,
    "created_at": "2023-07-06T14:35:58Z",
    "description": "French standard VAT"
  }
}

cURL

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request POST "$LAGO_URL/api/v1/taxes" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
    "tax": {
      "name": "TVA",
      "code": "french_standard_vat",
      "rate": "20.0",
      "description": "French standard VAT",
      "applied_to_organization": false
    }
  }'

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Tax creation payload

tax · object · required

Show child attributes

Response

200

application/json

Tax created

tax · object · required

Show child attributes