HostBill icon

HostBill

Consume HostBill API (v.0.1.3)

Overview

This node allows you to delete a contact from a client's profile in HostBill via its API. It is useful for automating the removal of client contacts, such as when a contact leaves an organization or needs to be disassociated from a client account. For example, you might use this node in a workflow that synchronizes your CRM with HostBill, ensuring that removed contacts are also deleted from HostBill.

Properties

Name Type Meaning
Contact ID to Remove String The unique identifier of the contact you want to remove from the client.
Client ID String The main profile ID of the client from which the contact is being removed.

Output

The output will be a JSON object (or array of objects if processing multiple items) representing the result of the delete operation. Typical fields may include:

  • A success indicator or status message.
  • If an error occurs and "Continue On Fail" is enabled, an error field with the error message.

Example output:

[
  {
    "success": true,
    "message": "Contact removed successfully."
  }
]

Or, on error (with "Continue On Fail"):

[
  {
    "error": "Contact not found."
  }
]

Dependencies

  • HostBill API: Requires valid HostBill API credentials configured in n8n under the name hostBillApi.
  • n8n Configuration: No additional environment variables required beyond standard credential setup.

Troubleshooting

  • Invalid Credentials: If the API credentials are incorrect or missing, the node will throw an authentication error. Ensure your hostBillApi credentials are set up correctly in n8n.
  • Contact Not Found: If the provided Contact ID does not exist, you may receive an error message like "Contact not found.". Double-check the Contact ID.
  • Client ID Issues: If the Client ID is invalid or does not match the contact, the operation will fail. Verify both IDs before running the workflow.
  • API Connectivity: Network issues or HostBill API downtime can cause connection errors.

Links and References

Discussion