> ## Documentation Index
> Fetch the complete documentation index at: https://lago-ftr-wallet-improvements.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a tax rate

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

<RequestExample>
  ```bash 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
      }
    }'
  ```

  ```python Python
  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)
  ```

  ```ruby Ruby
  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)
  ```

  ```js Javascript
  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 });
  ```

  ```go Go
  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)
  }
  ```

  ```csharp C#
  using System.Collections.Generic;
  using System.Diagnostics;
  using Org.OpenAPITools.Api;
  using Org.OpenAPITools.Client;
  using Org.OpenAPITools.Model;

  namespace Example
  {
      public class CreateTaxExample
      {
          public static void Main()
          {
              Configuration.Default.BasePath = "https://api.getlago.com/api/v1";
              Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

              var apiInstance = new TaxApi(Configuration.Default);
              var taxInput = new TaxInput(
  							Plan = new TaxInputTax(
                  Name = "TVA",
  						    Code = "french_standard_vat",
  						    Rate = "20.0",
  						    Description = "French standard VAT",
  						    AppliedToOrganization = false,
  							)
  						);

              try
              {
                  Tax result = apiInstance.CreateTax(taxInput);
              }
              catch (ApiException e)
              {

              }
          }
      }
  }
  ```

  ```php PHP
  require_once(__DIR__ . '/vendor/autoload.php');

  $config = OpenAPI\Client\Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

  $apiInstance = new OpenAPI\Client\Api\TaxesApi(
      new GuzzleHttp\Client(),
      $config
  );
  $tax_input = new \OpenAPI\Client\Model\TaxInput(
  	new \OpenAPI\Client\Model\TaxInputTax(
      "TVA",
      "french_standard_vat",
      "20.0",
      "French standard VAT",
      false,
  	)
  );

  try {
      $result = $apiInstance->createTax($tax_input);
      print_r($result);
  } catch (Exception $e) {
      echo $e->getMessage(), PHP_EOL;
  }
  ```
</RequestExample>