Billwerk icon

Billwerk

Automate your subscription business with billwerk

Actions27

Overview

This node allows you to create a new customer in Billwerk, an automated subscription management platform. It is useful for automating the onboarding of customers, syncing external customer databases with Billwerk, or integrating customer creation into broader business workflows (e.g., after a signup form submission). For example, you could use this node to automatically add a new customer to Billwerk whenever a new user registers on your website.

Properties

Name Type Meaning
Customer Data Collection The main group of fields containing all customer information to be created.
└ Customer External ID String Unique external identifier for the customer (e.g., foreign key from another system).
└ Company Name String The company name of the customer.
└ First Name String The customer's first name.
└ Last Name String The customer's last name.
└ VAT ID String The company's VAT identification number (validated by Billwerk).
└ Email String The customer's email address.
└ Phone Number String The customer's phone number.
└ Notes String Free text notes about the customer.
└ Address Collection The postal address details for the customer.
  └ Street Name String Street name of the address.
  └ House Number String House/building number.
  └ Line 1 String Additional address line.
  └ Postal/ZIP Code String Postal or ZIP code.
  └ City String City name.
  └ State String State or region.
  └ Country String Country in ISO-3166 alpha-2 format (e.g., "DE" for Germany).
└ Custom Fields FixedCollection List of custom fields as name/value pairs for additional customer data.

Output

The node returns a JSON object representing the newly created customer. The structure typically includes:

{
  "id": "string",                  // Billwerk's unique customer ID
  "externalCustomerId": "string",  // Your provided external ID
  "companyName": "string",
  "firstName": "string",
  "lastName": "string",
  "vatId": "string",
  "emailAddress": "string",
  "phoneNumber": "string",
  "notes": "string",
  "address": {
    "street": "string",
    "houseNumber": "string",
    "addressLine1": "string",
    "postalCode": "string",
    "city": "string",
    "state": "string",
    "country": "string"
  },
  "customFields": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  // ...other fields returned by Billwerk API
}

If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.

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:

  • Missing Required Fields: If mandatory fields (like Address) are not provided, the node may throw validation errors.
  • Invalid VAT ID or Country Code: Providing an invalid VAT ID or country code will result in API errors.
  • Authentication Errors: Incorrect or missing Billwerk API credentials will prevent successful execution.

Error Messages:

  • "error": "Some required field is missing" – Ensure all required fields are filled.
  • "error": "Invalid VAT ID" – Double-check the VAT ID format and value.
  • "error": "Authentication failed" – Verify your Billwerk API credentials in n8n.

Links and References

Discussion