OnOffice Address

Work with OnOffice address records

Actions4

Overview

This node integrates with the OnOffice API to manage address records. Specifically, for the Create operation, it allows users to create new address entries in the OnOffice system by specifying selected fields such as name, email, phone, and address details.

Common scenarios where this node is beneficial include:

  • Automating the addition of new contacts or clients into the OnOffice CRM from other systems.
  • Synchronizing user data collected from web forms or other applications directly into OnOffice.
  • Batch creating multiple address records programmatically within an n8n workflow.

For example, a real estate agency could use this node to automatically add new client addresses gathered from a website inquiry form into their OnOffice database.

Properties

Name Meaning
Fields to Include Select which fields to include when creating the address record. Options: Form of Address, First Name, Last Name, Email, Phone 1, Street, Postal Code, City, Country. This selection controls which additional input fields appear.
Form of Address The salutation or form of address for the contact. Options: Mr, Mrs, Company.
First Name The first name of the contact.
Last Name The last name of the contact.
Email The email address of the contact.
Phone 1 Primary phone number of the contact.
Street Street address.
Postal Code Postal or ZIP code.
City City name.
Country Country name. Defaults to "Deutschland" (Germany).

The user must select at least one field to include, and then provide values for those fields accordingly.

Output

The node outputs a JSON object containing the result of the create operation. The structure includes:

  • success: Boolean indicating if the creation was successful.
  • operation: The operation performed, here always "create".
  • data: An object with the created address data returned from the OnOffice API.
  • message: A status message from the API response.

Example output JSON snippet:

{
  "success": true,
  "operation": "create",
  "data": {
    // Created address record details as returned by OnOffice
  },
  "message": "Record created successfully"
}

No binary data output is produced by this node.

Dependencies

  • Requires valid credentials for the OnOffice API, specifically an API token and secret.
  • The node communicates with the OnOffice REST API endpoint at https://api.onoffice.de/api/latest/api.php.
  • Proper configuration of the API credentials in n8n is necessary before using this node.

Troubleshooting

  • API Authentication Errors: If the API token or secret are invalid or missing, the node will fail with an authentication error. Ensure that the API credentials are correctly set up in n8n.
  • Missing Required Fields: The node requires at least one field to be included and provided. Omitting required fields may cause the API to reject the request.
  • API Action Errors: The node surfaces errors returned by the OnOffice API, including messages describing what went wrong. Review the error message for guidance.
  • Network Issues: Connectivity problems to the OnOffice API endpoint can cause failures. Verify network access and endpoint availability.
  • Continue on Fail: If enabled, the node will continue processing subsequent items even if some fail, returning error details in the output JSON.

Links and References

Discussion