Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Tax Rates → Update Tax Rates

AI-generated

Overview

This node updates tax rates for a specified account by sending a JSON object representing the tax rate details to an external API. It is useful in scenarios where you need to programmatically modify tax rate configurations, such as updating tax percentages, names, or other related fields without manually accessing the external system's interface.

Practical examples include:

  • Automating tax rate adjustments based on changing regulations.
  • Synchronizing tax rates from an internal database to an external accounting or billing system.
  • Bulk updating multiple tax rates via workflows.

Properties

Name Meaning
Account Id Identifier of the account for which the tax rate will be updated.
Body JSON object containing the tax rate data to update. This should exclude autogenerated fields and follow the expected schema of the tax rate object.

Output

The node outputs JSON data representing the response from the external API after attempting to update the tax rate. This typically includes the updated tax rate details or status information confirming the success or failure of the operation.

No binary data output is indicated.

Dependencies

  • Requires an API key credential or similar authentication token configured in n8n to authorize requests to the external service.
  • The base URL for the API must be set in the node credentials or environment variables.
  • The node depends on an OpenAPI specification internally to define operations and properties but this is abstracted away from the user.

Troubleshooting

  • Invalid Account Id: If the provided account identifier does not exist or is incorrect, the API may return an error indicating the resource was not found. Verify the account ID before running the node.
  • Malformed JSON in Body: Since the body property expects valid JSON, any syntax errors or invalid structure will cause the request to fail. Use proper JSON formatting and ensure required fields are included.
  • Authentication Errors: Missing or invalid API credentials will result in authorization failures. Confirm that the API key or token is correctly configured in n8n.
  • API Rate Limits or Downtime: External API limits or outages can cause errors or timeouts. Check the external service status if unexpected failures occur.

Links and References

  • Refer to the external API documentation for the exact schema of the tax rate object and supported fields.
  • n8n documentation on using JSON input properties and configuring API credentials.

Discussion