Create a new tax

curl --request POST \
  --url https://api.devdraft.ai/api/v0/taxes \
  --header 'Content-Type: application/json' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "name": "Sales Tax",
  "percentage": 8.5,
  "description": "Standard sales tax for retail transactions",
  "active": true,
  "appIds": [
    "app_123e4567-e89b-12d3-a456-426614174000"
  ]
}
'

import requests

url = "https://api.devdraft.ai/api/v0/taxes"

payload = {
    "name": "Sales Tax",
    "percentage": 8.5,
    "description": "Standard sales tax for retail transactions",
    "active": True,
    "appIds": ["app_123e4567-e89b-12d3-a456-426614174000"]
}
headers = {
    "x-client-secret": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-client-secret': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Sales Tax',
    percentage: 8.5,
    description: 'Standard sales tax for retail transactions',
    active: true,
    appIds: ['app_123e4567-e89b-12d3-a456-426614174000']
  })
};

fetch('https://api.devdraft.ai/api/v0/taxes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.devdraft.ai/api/v0/taxes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Sales Tax',
    'percentage' => 8.5,
    'description' => 'Standard sales tax for retail transactions',
    'active' => true,
    'appIds' => [
        'app_123e4567-e89b-12d3-a456-426614174000'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-client-secret: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.devdraft.ai/api/v0/taxes"

	payload := strings.NewReader("{\n  \"name\": \"Sales Tax\",\n  \"percentage\": 8.5,\n  \"description\": \"Standard sales tax for retail transactions\",\n  \"active\": true,\n  \"appIds\": [\n    \"app_123e4567-e89b-12d3-a456-426614174000\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-client-secret", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.devdraft.ai/api/v0/taxes")
  .header("x-client-secret", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Sales Tax\",\n  \"percentage\": 8.5,\n  \"description\": \"Standard sales tax for retail transactions\",\n  \"active\": true,\n  \"appIds\": [\n    \"app_123e4567-e89b-12d3-a456-426614174000\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.devdraft.ai/api/v0/taxes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-client-secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Sales Tax\",\n  \"percentage\": 8.5,\n  \"description\": \"Standard sales tax for retail transactions\",\n  \"active\": true,\n  \"appIds\": [\n    \"app_123e4567-e89b-12d3-a456-426614174000\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "tax_123e4567-e89b-12d3-a456-426614174000",
  "name": "Sales Tax",
  "description": "Standard sales tax for retail transactions",
  "percentage": 8.5,
  "active": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Taxes

Create a new tax

Creates a new tax rate that can be applied to products, invoices, and payment links.

Use Cases

Set up sales tax for different regions
Create VAT rates for international customers
Configure state and local tax rates
Manage tax compliance requirements

Example: Create Basic Sales Tax

{
  "name": "Sales Tax",
  "description": "Standard sales tax for retail transactions",
  "percentage": 8.5,
  "active": true
}

Required Fields

name: Tax name for identification (1-100 characters)
percentage: Tax rate percentage (0-100)

Optional Fields

description: Explanation of what this tax covers (max 255 characters)
active: Whether this tax is currently active (default: true)
appIds: Array of app IDs where this tax should be available

POST

api

taxes

Create a new tax

curl --request POST \
  --url https://api.devdraft.ai/api/v0/taxes \
  --header 'Content-Type: application/json' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "name": "Sales Tax",
  "percentage": 8.5,
  "description": "Standard sales tax for retail transactions",
  "active": true,
  "appIds": [
    "app_123e4567-e89b-12d3-a456-426614174000"
  ]
}
'

import requests

url = "https://api.devdraft.ai/api/v0/taxes"

payload = {
    "name": "Sales Tax",
    "percentage": 8.5,
    "description": "Standard sales tax for retail transactions",
    "active": True,
    "appIds": ["app_123e4567-e89b-12d3-a456-426614174000"]
}
headers = {
    "x-client-secret": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-client-secret': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Sales Tax',
    percentage: 8.5,
    description: 'Standard sales tax for retail transactions',
    active: true,
    appIds: ['app_123e4567-e89b-12d3-a456-426614174000']
  })
};

fetch('https://api.devdraft.ai/api/v0/taxes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.devdraft.ai/api/v0/taxes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Sales Tax',
    'percentage' => 8.5,
    'description' => 'Standard sales tax for retail transactions',
    'active' => true,
    'appIds' => [
        'app_123e4567-e89b-12d3-a456-426614174000'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-client-secret: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.devdraft.ai/api/v0/taxes"

	payload := strings.NewReader("{\n  \"name\": \"Sales Tax\",\n  \"percentage\": 8.5,\n  \"description\": \"Standard sales tax for retail transactions\",\n  \"active\": true,\n  \"appIds\": [\n    \"app_123e4567-e89b-12d3-a456-426614174000\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-client-secret", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.devdraft.ai/api/v0/taxes")
  .header("x-client-secret", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Sales Tax\",\n  \"percentage\": 8.5,\n  \"description\": \"Standard sales tax for retail transactions\",\n  \"active\": true,\n  \"appIds\": [\n    \"app_123e4567-e89b-12d3-a456-426614174000\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.devdraft.ai/api/v0/taxes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-client-secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Sales Tax\",\n  \"percentage\": 8.5,\n  \"description\": \"Standard sales tax for retail transactions\",\n  \"active\": true,\n  \"appIds\": [\n    \"app_123e4567-e89b-12d3-a456-426614174000\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "tax_123e4567-e89b-12d3-a456-426614174000",
  "name": "Sales Tax",
  "description": "Standard sales tax for retail transactions",
  "percentage": 8.5,
  "active": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

x-client-secret

string

header

required

Your secret API key. Keep this secure and never expose it in client-side code.

Body

application/json

Tax creation data

name

string

required

Tax name. Used to identify and reference this tax rate.

Required string length: 1 - 100

Example:

"Sales Tax"

percentage

number

required

Tax percentage rate. Must be between 0 and 100.

Required range: 0 <= x <= 100

Example:

8.5

description

string

Optional description explaining what this tax covers.

Maximum string length: 255

Example:

"Standard sales tax for retail transactions"

active

boolean

default:true

Whether this tax is currently active and can be applied.

Example:

true

appIds

string<uuid>[]

Array of app IDs where this tax should be available. If not provided, tax will be available for the current app.

Example:

["app_123e4567-e89b-12d3-a456-426614174000"]

Response

Tax created successfully

string

Example:

"tax_123e4567-e89b-12d3-a456-426614174000"

name

string

Example:

"Sales Tax"

description

string

Example:

"Standard sales tax for retail transactions"

percentage

number

Example:

8.5

active

boolean

Example:

true

created_at

string<date-time>

updated_at

string<date-time>

API Health

Test Payments

Customers

Payment Links

Payment Intents

Webhooks

Wallets

Transfers

Liquidation Addresses

App Balances

Exchange Rates

Products

Invoices

Taxes

Create a new tax

Use Cases

Example: Create Basic Sales Tax

Required Fields

Optional Fields

Authorizations

Body

Response