Update Product

Update a product

curl --request PUT \
  --url https://api.timbrix.mx/organizations/{organizationId}/products/{productId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "Ukelele",
  "productKey": 60131324,
  "price": 345.6,
  "taxIncluded": true,
  "taxability": "01",
  "taxes": [],
  "localTaxes": [],
  "unitKey": "H87",
  "unitName": "Elemento",
  "sku": "UKL-001",
  "livemode": true
}
'

import requests

url = "https://api.timbrix.mx/organizations/{organizationId}/products/{productId}"

payload = {
    "description": "Ukelele",
    "productKey": 60131324,
    "price": 345.6,
    "taxIncluded": True,
    "taxability": "01",
    "taxes": [],
    "localTaxes": [],
    "unitKey": "H87",
    "unitName": "Elemento",
    "sku": "UKL-001",
    "livemode": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    description: 'Ukelele',
    productKey: 60131324,
    price: 345.6,
    taxIncluded: true,
    taxability: '01',
    taxes: [],
    localTaxes: [],
    unitKey: 'H87',
    unitName: 'Elemento',
    sku: 'UKL-001',
    livemode: true
  })
};

fetch('https://api.timbrix.mx/organizations/{organizationId}/products/{productId}', 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.timbrix.mx/organizations/{organizationId}/products/{productId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'description' => 'Ukelele',
    'productKey' => 60131324,
    'price' => 345.6,
    'taxIncluded' => true,
    'taxability' => '01',
    'taxes' => [
        
    ],
    'localTaxes' => [
        
    ],
    'unitKey' => 'H87',
    'unitName' => 'Elemento',
    'sku' => 'UKL-001',
    'livemode' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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.timbrix.mx/organizations/{organizationId}/products/{productId}"

	payload := strings.NewReader("{\n  \"description\": \"Ukelele\",\n  \"productKey\": 60131324,\n  \"price\": 345.6,\n  \"taxIncluded\": true,\n  \"taxability\": \"01\",\n  \"taxes\": [],\n  \"localTaxes\": [],\n  \"unitKey\": \"H87\",\n  \"unitName\": \"Elemento\",\n  \"sku\": \"UKL-001\",\n  \"livemode\": true\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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.put("https://api.timbrix.mx/organizations/{organizationId}/products/{productId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"Ukelele\",\n  \"productKey\": 60131324,\n  \"price\": 345.6,\n  \"taxIncluded\": true,\n  \"taxability\": \"01\",\n  \"taxes\": [],\n  \"localTaxes\": [],\n  \"unitKey\": \"H87\",\n  \"unitName\": \"Elemento\",\n  \"sku\": \"UKL-001\",\n  \"livemode\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.timbrix.mx/organizations/{organizationId}/products/{productId}")

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"description\": \"Ukelele\",\n  \"productKey\": 60131324,\n  \"price\": 345.6,\n  \"taxIncluded\": true,\n  \"taxability\": \"01\",\n  \"taxes\": [],\n  \"localTaxes\": [],\n  \"unitKey\": \"H87\",\n  \"unitName\": \"Elemento\",\n  \"sku\": \"UKL-001\",\n  \"livemode\": true\n}"

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

{
  "id": "590ce6c56d04f840aa8438af",
  "organizationId": "org-uuid",
  "livemode": false,
  "description": "Ukelele",
  "productKey": 60131324,
  "price": 345.6,
  "taxIncluded": true,
  "taxability": "01",
  "taxes": [
    {
      "type": "IVA",
      "rate": 0.16,
      "withholding": false,
      "factor": "Tasa"
    }
  ],
  "localTaxes": [
    {
      "type": "IVA",
      "rate": 0.16,
      "withholding": false,
      "factor": "Tasa"
    }
  ],
  "unitKey": "H87",
  "unitName": "Elemento",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "sku": "UKL-001"
}

PUT

organizations

{organizationId}

products

{productId}

Update a product

curl --request PUT \
  --url https://api.timbrix.mx/organizations/{organizationId}/products/{productId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "Ukelele",
  "productKey": 60131324,
  "price": 345.6,
  "taxIncluded": true,
  "taxability": "01",
  "taxes": [],
  "localTaxes": [],
  "unitKey": "H87",
  "unitName": "Elemento",
  "sku": "UKL-001",
  "livemode": true
}
'

import requests

url = "https://api.timbrix.mx/organizations/{organizationId}/products/{productId}"

payload = {
    "description": "Ukelele",
    "productKey": 60131324,
    "price": 345.6,
    "taxIncluded": True,
    "taxability": "01",
    "taxes": [],
    "localTaxes": [],
    "unitKey": "H87",
    "unitName": "Elemento",
    "sku": "UKL-001",
    "livemode": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    description: 'Ukelele',
    productKey: 60131324,
    price: 345.6,
    taxIncluded: true,
    taxability: '01',
    taxes: [],
    localTaxes: [],
    unitKey: 'H87',
    unitName: 'Elemento',
    sku: 'UKL-001',
    livemode: true
  })
};

fetch('https://api.timbrix.mx/organizations/{organizationId}/products/{productId}', 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.timbrix.mx/organizations/{organizationId}/products/{productId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'description' => 'Ukelele',
    'productKey' => 60131324,
    'price' => 345.6,
    'taxIncluded' => true,
    'taxability' => '01',
    'taxes' => [
        
    ],
    'localTaxes' => [
        
    ],
    'unitKey' => 'H87',
    'unitName' => 'Elemento',
    'sku' => 'UKL-001',
    'livemode' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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.timbrix.mx/organizations/{organizationId}/products/{productId}"

	payload := strings.NewReader("{\n  \"description\": \"Ukelele\",\n  \"productKey\": 60131324,\n  \"price\": 345.6,\n  \"taxIncluded\": true,\n  \"taxability\": \"01\",\n  \"taxes\": [],\n  \"localTaxes\": [],\n  \"unitKey\": \"H87\",\n  \"unitName\": \"Elemento\",\n  \"sku\": \"UKL-001\",\n  \"livemode\": true\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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.put("https://api.timbrix.mx/organizations/{organizationId}/products/{productId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"Ukelele\",\n  \"productKey\": 60131324,\n  \"price\": 345.6,\n  \"taxIncluded\": true,\n  \"taxability\": \"01\",\n  \"taxes\": [],\n  \"localTaxes\": [],\n  \"unitKey\": \"H87\",\n  \"unitName\": \"Elemento\",\n  \"sku\": \"UKL-001\",\n  \"livemode\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.timbrix.mx/organizations/{organizationId}/products/{productId}")

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"description\": \"Ukelele\",\n  \"productKey\": 60131324,\n  \"price\": 345.6,\n  \"taxIncluded\": true,\n  \"taxability\": \"01\",\n  \"taxes\": [],\n  \"localTaxes\": [],\n  \"unitKey\": \"H87\",\n  \"unitName\": \"Elemento\",\n  \"sku\": \"UKL-001\",\n  \"livemode\": true\n}"

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

{
  "id": "590ce6c56d04f840aa8438af",
  "organizationId": "org-uuid",
  "livemode": false,
  "description": "Ukelele",
  "productKey": 60131324,
  "price": 345.6,
  "taxIncluded": true,
  "taxability": "01",
  "taxes": [
    {
      "type": "IVA",
      "rate": 0.16,
      "withholding": false,
      "factor": "Tasa"
    }
  ],
  "localTaxes": [
    {
      "type": "IVA",
      "rate": 0.16,
      "withholding": false,
      "factor": "Tasa"
    }
  ],
  "unitKey": "H87",
  "unitName": "Elemento",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "sku": "UKL-001"
}

Updates an existing product or service. All fields are optional — only the fields you send will be updated.

Authentication

Requires a valid Bearer token. The authenticated user must be an owner or admin of the organization.

Path Parameters

Parameter	Type	Required	Description
`organizationId`	string (UUID)	Yes	Organization ID
`productId`	string (UUID)	Yes	Product ID

Request Body

All fields are optional.

Field	Type	Description
`description`	string	Product or service description
`productKey`	integer	SAT product/service key
`price`	number	Unit price
`taxIncluded`	boolean	Whether taxes are included in the price
`taxability`	string	SAT taxability code
`taxes`	array	List of applicable taxes (replaces existing)
`localTaxes`	array	List of applicable local taxes (replaces existing)
`unitKey`	string	SAT unit of measure key
`unitName`	string	Unit of measure name
`sku`	string	Internal product SKU
`livemode`	boolean	Whether this is a live mode product

Example Request

curl -X PUT https://api.timbrix.mx/organizations/550e8400-e29b-41d4-a716-446655440000/products/590ce6c56d04f840aa8438af \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "price": 400.0,
    "sku": "UKL-002"
  }'

Example Response

{
  "id": "590ce6c56d04f840aa8438af",
  "organizationId": "550e8400-e29b-41d4-a716-446655440000",
  "livemode": true,
  "description": "Ukelele",
  "productKey": 60131324,
  "price": 400.0,
  "taxIncluded": true,
  "taxability": "01",
  "taxes": [{ "type": "IVA", "rate": 0.16 }],
  "localTaxes": [],
  "unitKey": "H87",
  "unitName": "Elemento",
  "sku": "UKL-002",
  "createdAt": "2025-01-26T10:00:00Z",
  "updatedAt": "2025-01-26T11:00:00Z"
}

Common Errors

404 Not Found

Product does not exist or does not belong to the organization.

409 Conflict

A product with the new SKU already exists in this organization.

Authorizations

Authorization

string

header

required

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

Path Parameters

organizationId

string

required

productId

string

required

Body

application/json

description

string

Product or service description

Example:

"Ukelele"

productKey

number

SAT product/service key (clave de producto o servicio)

Example:

60131324

price

number

Unit price

Example:

345.6

taxIncluded

boolean

default:false

Whether taxes are already included in the price

Example:

true

taxability

string

default:01

SAT taxability code (objeto de impuesto)

Example:

"01"

taxes

object[]

Applicable taxes

Show child attributes

localTaxes

object[]

Applicable local taxes

Show child attributes

unitKey

string

default:H87

SAT unit of measure key (clave de unidad)

Example:

"H87"

unitName

string

default:Elemento

Unit of measure name

Example:

"Elemento"

sku

string

Internal SKU or identifier

Example:

"UKL-001"

livemode

boolean

default:true

Whether this is a live mode product

Example:

true

Response

200 - application/json

string

required

Example:

"590ce6c56d04f840aa8438af"

organizationId

string

required

Example:

"org-uuid"

livemode

boolean

required

Example:

false

description

string

required

Example:

"Ukelele"

productKey

number

required

Example:

60131324

price

number

required

Example:

345.6

taxIncluded

boolean

required

Example:

true

taxability

string

required

Example:

"01"

taxes

object[]

required

Show child attributes

localTaxes

object[]

required

Show child attributes

unitKey

string

required

Example:

"H87"

unitName

string

required

Example:

"Elemento"

createdAt

string<date-time>

required

updatedAt

string<date-time>

required

sku

object

Example:

"UKL-001"

API documentation

Organizations

Members

Invites

Auth

OAuth

Customers

SAT Catalogs

Invoices

Products

Users

Webhooks

API Keys

Authentication

Path Parameters

Request Body

Example Request

Example Response

Common Errors

404 Not Found

409 Conflict

Authorizations

Path Parameters

Body

Response

​Authentication

​Path Parameters

​Request Body

​Example Request

​Example Response

​Common Errors

​404 Not Found

​409 Conflict

Authorizations

Path Parameters

Body

Response

Authentication

Path Parameters

Request Body

Example Request

Example Response

Common Errors

404 Not Found

409 Conflict