Clockodo

Clockodo is a cloud-based time-tracking and project management software designed for businesses. It helps organizations track working hours, manage projects, and generate invoices efficiently. Clockodo provides an intuitive interface to log billable hours, assign tasks, and monitor team productivity.

How to Integrate Clockodo with ZBrain Flow

To integrate Clockodo with ZBrain Flow:

• Click the ‘+’ button in ZBrain Flow.

• In the search bar, type "Clockodo" and select it from the available options.

• Select an available action to begin the setup process.

How to Connect Clockodo to ZBrain Flow

To establish a connection between Clockodo and ZBrain Flow:

• Enter a Connection Name – Provide a name for the connection to identify it easily.

• Enter the Email - Enter the email address associated with your Clockodo account.

• Enter the API Token – Enter your Clockodo API token.

• Enter the Company Name and Email - Enter the name of your company and email.

• Click ‘Save’ – Finalize the setup and begin using Clockodo actions within ZBrain Flow.

To find your API token in Clockodo, follow these steps:

1. Log in to your Clockodo account

2. Access your account settings:

   • Once logged in, look for your profile icon or name, usually located at the top right corner of the dashboard.

   • Click on it to open a dropdown menu and select "Account settings" or "Personal data."

3. Navigate to the API section:

   • In the account settings, find the section labeled "API" or "API access.”

   • This section might be under a tab like "Integrations" or "Developer settings.”

4. Generate or view your API token:

   • If you haven't generated an API token before, you might see an option to create one. Click on "Generate API token" or a similar button.

   • If you already have an API token, it should be displayed in this section. You can copy it directly from here.

5. Use your API token:

   • When making API requests, include your API token in the request headers or parameters as specified in the Clockodo API documentation.

Once connected, ZBrain Flow can interact with Clockodo to manage time entries, retrieve information, and automate workflows.

Actions Available in ZBrain Flow

1. Create Entry

The Create Entry action allows users to create a new time-tracking entry in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Select the Customer – Provide the customer ID.

3. Select the Project – Provide the project ID.

4. Select the Service – Provide the service ID.

5. Enter the Start and End Time – Define the duration of the entry.

6. Enter Additional Details – Add a description, specify the hourly rate, and assign a user.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

2. Get Entry

The Get Entry action retrieves a specific time entry from Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Entry ID – Provide the unique identifier of the time entry.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

3. Get Entries

The Get Entries action fetches multiple time-tracking entries from Clockodo, allowing users to filter results based on specific criteria.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Start and End Date – Define the date range for retrieving entries.

3. Apply filters:

   • Customer ID Filter – Retrieve entries associated with a specific customer.

   • Project ID Filter – Retrieve entries linked to a specific project.

   • Service ID Filter – Retrieve entries related to a specific service.

4. Enable/Disable Options:

   • Billable – Show only billable entries.

   • Billed – Show only entries that have already been billed.

   • Enhanced List – Retrieve additional details about the entries.

5. Enter the Page Number – Specify the page to read if pagination is required.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

4. Update Entry

The Update Entry action modifies an existing time-tracking entry in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Entry ID – Provide the unique identifier of the entry.

3. Select the Customer – Provide the customer ID.

4. Select the Project – Provide the project ID.

5. Select the Service – Provide the service ID.

6. Enter the Start and End Time – Define the duration of the entry.

7. Enter Additional Details – Add a description and assign a user.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

5. Delete Entry

The Delete Entry action removes a time-tracking entry from Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Entry ID – Provide the unique identifier of the entry to be deleted.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

6. Create Customer

The Create Customer action adds a new customer to Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter Customer Details:

   • Name – Provide the customer’s name.

   • Number – Assign a unique customer number.

3. Enable/Disable Options:

   • Active – Mark the customer as active.

   • Billable – Indicate if the customer is billable.

4. Enter Additional Details:

   • Note – Add any relevant notes.

   • Color – Select a color for categorization.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

7. Get Customer

The Get Customer action retrieves details of a specific customer in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Customer ID – Provide the unique identifier of the customer.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

8. Update Customer

The Update Customer action modifies an existing customer’s details in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Customer ID – Provide the unique identifier of the customer.

3. Enter Updated Customer Details:

   • Name – Modify the customer’s name.

   • Number – Update the customer’s number.

4. Enable/Disable Options:

   • Active – Mark the customer as active.

   • Billable – Indicate if the customer is billable.

5. Enter Additional Details:

   • Note – Add or update notes.

   • Color – Select or modify the assigned color.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

9. Get Customers

The Get Customers action retrieves multiple customers from Clockodo with filtering options.

Configuration Steps:

• Select a Connection – Choose an existing connection or create a new one.

• Enable/Disable the Active Filter – Filter customers based on their active status.

• Enter the Page Number – Specify the page to read if pagination is required.

Note: Click ‘f’ to insert dynamic values for flexible configurations

10. Delete Customer

The Delete Customer action removes a customer from Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Customer ID – Provide the unique identifier of the customer to be deleted.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

11. Create Project

The Create Project action adds a new project in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter Project Details:

   • Name – Provide the project’s name.

   • Customer ID – Assign a customer to the project.

   • Number – Assign a unique project number.

3. Enable/Disable Options:

   • Active – Mark the project as active.

   • Billable – Indicate if the project is billable.

4. Enter the Budget – Specify the budget for the project.

5. Enable/Disable Additional Options:

   • Budget in hours – Track the budget in hours.

   • Soft budget – Get warnings when the budget limit is reached.

6. Enter a Note – Add any relevant information.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

12. Get Project

The Get Project action retrieves details of a specific project in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Project ID – Provide the unique identifier of the project.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

13. Get Projects

The Get Projects action fetches multiple projects from Clockodo with filtering options.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter Filters:

   • Customer ID – Filter projects by customer.

   • Enable/Disable Active filter – Show only active projects.

3. Enter the Page Number – Specify the page to read if pagination is required.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

14. Update Project

The Update Project action modifies an existing project in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter Project Details:

   • Project ID – Identify the project to update.

   • Customer ID – Assign or update the customer.

   • Name and Number – Modify project name and number.

3. Enable/Disable Options:

   • Active – Set project status.

   • Billable – Indicate billable status.

4. Enter the Budget – Update the budget.

5. Enable/Disable Additional Options:

   • Budget in Hours – Track in hours.

   • Soft Budget – Receive warnings on budget limits.

6. Provide Note – Enter relevant details or additional information.

   • Completed – Mark the project as completed.

7. Enter Billed Amount – Specify the billed amount.

8. Enable/Disable Billing Complete – Mark as fully billed.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

15. Delete Project

The Delete Project action removes a project from Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Project ID – Provide the unique identifier of the project.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

16. Create Service

The Create Service action adds a new service to Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter Service Details:

   • Name – Provide the service name.

   • Number – Assign a unique number.

3. Enable/Disable Active – Set service status.

4. Enter a Note – Add additional details.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

17. Get Service

The Get Service action retrieves details of a specific service in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Service ID – Provide the unique identifier of the service.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

18. Update Service

The Update Service action modifies an existing service in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter Service Details:

   • Service ID – Identify the service to update.

   • Name and Number – Modify service name and number.

3. Enable/Disable Active – Update the service status.

4. Enter a Note – Add or update additional information.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

19. Get Services

The Get Services action retrieves multiple services from Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

20. Delete Service

The Delete Service action removes a service from Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Service ID – Provide the unique identifier of the service.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

21. Get Team

The Get Team action retrieves details of a specific team in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Team ID – Provide the unique identifier ofTeam team.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

22. Get Teams

The Get Teams action retrieves a list of teams from Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

23. Get User

The Get User action retrieves details of a specific user in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the User ID – Provide the unique identifier of the user.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

24. Get Users

The Get Users action fetches multiple users from Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

25. Create User

The Create User action adds a new user to Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter User Details:

   • Name – Provide the user’s name.

   • Email – Enter the user’s email.

   • Role – Assign a role to the user.

   • Number – Provide a unique number.

   • Select the Team ID – Assign the user to a team.

   • Select Language – Choose the language preference.

   • Select Wage Type – Define the wage type.

3. Enable/Disable Options:

   • Can see absences

   • Can manage absences

   • Can add customers

Note: Click ‘f’ to insert dynamic values for flexible configurations.

26. Update User

The Update User action modifies an existing user's details in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the User ID – Provide the unique identifier of the user.

3. Enter Updated User Details:

   • Name – Modify the user’s name.

   • Email – Update the user’s email.

   • Role – Change the assigned role.

   • Number – Modify the unique number.

   • Enable/Disable Options:

     • Active – Mark the customer as active.

   • Select the Team ID – Assign the user to a different team.

   • Select Language – Change the language preference.

   • Select Wage Type – Update the wage type.

4. Enable/Disable Options:

   • Can see absences

   • Can manage absences

   • Can add customers

Note: Click ‘f’ to insert dynamic values for flexible configurations.

27. Delete User

The Delete User action removes a user from Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the User ID – Provide the unique identifier of the user to be deleted.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

28. Create Absence

The Create Absence action logs an absence for a user in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter Absence Details:

   • Start and End Date – Define the absence duration.

   • Select the Type – Choose the type of absence.

   • Select the User ID – Assign the absence to a user.

3. Enable/Disable Options:

   • Half Days

   • Approved

   • Sick Note

4. Enter a Note – Add any additional details.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

29. Get Absence

The Get Absence action retrieves details of a specific absence in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Absence ID – Provide the unique identifier of the absence.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

30. Update Absence

The Update Absence action modifies an existing absence entry in Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Absence ID – Provide the unique identifier of the absence.

3. Enter the Start and End Date – Define the updated absence duration.

4. Select the Type – Choose the type of absence.

5. Select the Status – Update the status of the absence.

6. Enable/Disable Options:

   • Half Days – Allow partial-day absences.

   • Sick Note – Indicate if a sick note is required.

7. Enter a Note – Add or update additional details.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

31. Get Absences

The Get Absences action retrieves multiple absence entries from Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Year – Specify the year for filtering absences.

3. Select the User ID – Retrieve absences for a specific user.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

32. Delete Absence

The Delete Absence action removes an absence entry from Clockodo.

Configuration Steps:

1. Select a Connection – Choose an existing connection or create a new one.

2. Enter the Absence ID – Provide the unique identifier of the absence to be deleted.

Note: Click ‘f’ to insert dynamic values for flexible configurations.

33. Custom API Call

The Custom API Call action allows users to interact with the Clockodo API for advanced operations.

Configuration Steps:

1. Enter the API endpoint URL – Specify the API endpoint.

2. Select the HTTP Method:

   • GET – Retrieve details.

   • POST – Create new records.

   • PATCH – Modify existing data.

   • PUT – Replace existing content.

   • DELETE – Remove records.

   • HEAD – Fetch response headers only.

3. Add Headers – Define additional headers if needed.

4. Add Query Parameters – Customize requests with filters or options.

5. Enter JSON Body – Provide structured request data.

6. Set Timeout (in seconds) – Define request timeout duration.

Note: Click ‘f’ to insert dynamic values for flexible configurations.