Alegra (Unofficial - BETA)

Overview

This node integrates with the Alegra API to manage contacts, invoices, items, payments, estimates, taxes, and bank accounts. Specifically, for the Contact resource with the Delete operation, it deletes a contact identified by its unique ID from the Alegra system.

Common scenarios where this node is beneficial include automating customer or vendor management workflows, such as cleaning up outdated or incorrect contact records in bulk or as part of a larger automation process.

Practical example: Automatically removing a client contact from Alegra when they unsubscribe from a service or are no longer active, ensuring your contact list stays current without manual intervention.

Properties

Output

The output JSON contains the response from the Alegra API after attempting to delete the specified contact. Typically, this will be an empty object or confirmation message indicating successful deletion. If an error occurs, the output may contain an error message describing the failure.

No binary data is output by this operation.

Example output JSON on success:

{}

Example output JSON on failure:

{
  "error": "Contact not found"
}

Dependencies

• Requires an API key credential for authenticating with the Alegra API.
• The node uses HTTP requests to the Alegra REST API endpoints.
• The base URL for API calls depends on the configured environment in the credentials.
• No additional external dependencies beyond the Alegra API and n8n's HTTP request helper.

Troubleshooting

• Common issues:

  • Providing an invalid or non-existent Contact ID will result in an error from the API.
  • Missing or incorrect API authentication credentials will cause authentication failures.
  • Network connectivity problems can prevent the node from reaching the Alegra API.

• Error messages:

  • "Contact not found": The specified Contact ID does not exist. Verify the ID is correct.
  • Authentication errors: Check that the API key credential is valid and has necessary permissions.
  • "Unknown error occurred": A generic catch-all error; check network connection and API status.

• Resolution tips:

  • Double-check the Contact ID input.
  • Ensure the API key credential is properly set up in n8n.
  • Test connectivity to the Alegra API outside n8n to rule out network issues.

Links and References

• Alegra API Documentation (official API docs for reference)
• n8n Documentation (for general node usage and credential setup)