Skip to main content
POST
/
taxes
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
    }
  }'
from lago_python_client.client import Client
from lago_python_client.exceptions import LagoApiError
from lago_python_client.models import Tax

client = Client(api_key='__YOUR_API_KEY__')

tax = Tax(
		name="TVA",
    code="french_standard_vat",
    rate="20.0",
    description="French standard VAT",
    applied_to_organization=false
)
try:
    client.taxes.create(tax)
except LagoApiError as e:
		# do something on error or raise your own exception
    repair_broken_state(e)
require 'lago-ruby-client'

client = Lago::Api::Client.new(api_key: '__YOUR_API_KEY__')

tax = {
	name: "TVA",
  code: "french_standard_vat",
  rate: "20.0",
  description: "French standard VAT",
  applied_to_organization: false
}

client.taxes.create(tax)
const taxObject = {
  name: "TVA",
  code: "french_standard_vat",
  rate: "20.0",
  description: "French standard VAT",
  applied_to_organization: false,
};

await client.taxes.createTax({ tax: taxObject });
import "fmt"
import "github.com/getlago/lago-go-client"

func main() {
  lagoClient := lago.New().SetApiKey("__YOUR_API_KEY__")

  taxInput := &lago.TaxInput{
    Name:                  "TVA",
    Code:                  "french_standard_vat",
    Rate:                  "20.0",
    Description:           "French standard VAT",
    AppliedToOrganization: false,
  }

  tax, err := lagoClient.Tax().Create(taxInput)
  if err != nil {
    // Error is *lago.Error
    panic(err)
  }

  // tax is *lago.Tax
  fmt.Println(tax)
}
{
  "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"
  }
}
{
  "status": 400,
  "error": "Bad request"
}
{
  "status": 401,
  "error": "Unauthorized"
}
{
  "status": 422,
  "error": "Unprocessable entity",
  "code": "validation_errors",
  "error_details": {}
}
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
    }
  }'
from lago_python_client.client import Client
from lago_python_client.exceptions import LagoApiError
from lago_python_client.models import Tax

client = Client(api_key='__YOUR_API_KEY__')

tax = Tax(
		name="TVA",
    code="french_standard_vat",
    rate="20.0",
    description="French standard VAT",
    applied_to_organization=false
)
try:
    client.taxes.create(tax)
except LagoApiError as e:
		# do something on error or raise your own exception
    repair_broken_state(e)
require 'lago-ruby-client'

client = Lago::Api::Client.new(api_key: '__YOUR_API_KEY__')

tax = {
	name: "TVA",
  code: "french_standard_vat",
  rate: "20.0",
  description: "French standard VAT",
  applied_to_organization: false
}

client.taxes.create(tax)
const taxObject = {
  name: "TVA",
  code: "french_standard_vat",
  rate: "20.0",
  description: "French standard VAT",
  applied_to_organization: false,
};

await client.taxes.createTax({ tax: taxObject });
import "fmt"
import "github.com/getlago/lago-go-client"

func main() {
  lagoClient := lago.New().SetApiKey("__YOUR_API_KEY__")

  taxInput := &lago.TaxInput{
    Name:                  "TVA",
    Code:                  "french_standard_vat",
    Rate:                  "20.0",
    Description:           "French standard VAT",
    AppliedToOrganization: false,
  }

  tax, err := lagoClient.Tax().Create(taxInput)
  if err != nil {
    // Error is *lago.Error
    panic(err)
  }

  // tax is *lago.Tax
  fmt.Println(tax)
}

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

Response

Tax created

tax
object
required