Billwerk icon

Billwerk

Automate your subscription business with billwerk

Actions27

Overview

The Billwerk node for n8n allows you to automate interactions with the Billwerk subscription management platform. Specifically, the Customer → Get All operation retrieves a list of customers from your Billwerk account, supporting advanced search and filtering options. This is useful for syncing customer data, building dashboards, or integrating customer information into other workflows.

Example scenarios:

  • Fetching all active customers to update a CRM.
  • Searching for customers by email or external ID for support automation.
  • Paginating through large customer lists for reporting or batch processing.

Properties

Name Type Meaning
Search String Search customers by External ID, First Name, Last Name, Company Name, Email Address, or Debitor Account.
Status Options Filter customers by status: All, Normal, Unconfirmed, or Deleted.
External ID String Search for a specific customer using their External ID.
From String Pagination: ID of the first customer to return in the result set.
Take Number Pagination: Maximum number of customers to return (up to 500).

Output

The output is an array of JSON objects, each representing a customer. The exact structure depends on the Billwerk API, but typically includes fields such as:

{
  "id": "string",
  "externalId": "string",
  "firstName": "string",
  "lastName": "string",
  "companyName": "string",
  "emailAddress": "string",
  "status": "string",
  // ...other customer fields
}
  • If an error occurs and "Continue On Fail" is enabled, the output will include an object like:
    { "error": "Error message here" }

Dependencies

  • External Service: Requires access to the Billwerk API.
  • Credentials: You must configure the billwerkApi credential in n8n.
  • Environment: No special environment variables are required beyond standard n8n setup.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the billwerkApi credentials are incorrect or missing, authentication errors will occur.
  • API Limits: Exceeding the maximum value for "Take" (over 500) may result in errors or truncated results.
  • Incorrect Filters: Using invalid values in filters (e.g., non-existent status) may yield empty results.

Error Messages:

  • "error": "Some error message": Indicates an issue with the request (e.g., network error, bad filter). Check the error message for details.
  • No Results Returned: Ensure that your search criteria match existing customers.

Links and References

Discussion