Automated Clockify to FreshBooks Time-to-Invoice Sync (Make.com)

1. **Create Scenario**: Log in to Make.com and click 'Create a new scenario'. 2. **Clockify Trigger**: Add the 'Clockify > Watch New Time Entries' module. Create a connection using your Clockify API Key. Set the 'Workspace ID' and choose the frequency of the check. 3. **Add Filter**: Click the link between the Clockify and next module. Set the condition where `Billable` (from Clockify) 'Equal to' `true`. This prevents non-billable internal work from hitting your books. 4. **Search Client**: Add 'FreshBooks > List Clients'. Map the `Client Name` from Clockify to the `Search` parameter in FreshBooks. 5. **Add Router**: Use a Router to check if the FreshBooks Client ID exists. If not, add a 'FreshBooks > Create a Client' module. 6. **Function: Convert Seconds to Hours**: In the next module ('FreshBooks > Create Time Entry'), use the Math function in the 'Duration/Hours' field: `{{round(item.timeInterval.duration / 3600; 2)}}`. Clockify outputs seconds, but FreshBooks requires decimal hours. 7. **Map Project**: Map the `Project Name` and `Description` from Clockify into the FreshBooks 'Notes' or 'Task Description' field. 8. **Data Consistency**: Ensure the `Date` field is mapped using `{{formatDate(item.timeInterval.start; "YYYY-MM-DD")}}` to match FreshBooks ISO requirements. 9. **Add Error Handler**: Right-click the FreshBooks module and select 'Add error handler' (Break). This ensures that if the FreshBooks API is down, Make.com will retry the execution later without losing the data bundle.

| Clockify Field | FreshBooks Field | Transformation / Syntax | Required? | | :--- | :--- | :--- | :--- | | `timeInterval.duration` | `Hours` | `{{round(duration / 3600; 2)}}` | Yes | | `description` | `Note` | `{{ifempty(description; "No description provided")}}` | Yes | | `timeInterval.start` | `Date` | `{{formatDate(start; "YYYY-MM-DD")}}` | Yes | | `projectName` | `Project ID` | Use 'Map' with `FreshBooks Project ID` | Yes | | `billable` | (Filter) | Set filter to `True` | Yes |

* **The Seconds Gap**: Clockify delivers duration in seconds (e.g., 3600). Mapping this directly to FreshBooks will result in 3600 hours being billed. Always use the `/ 3600` math formula in Make.com. * **Connection Scopes**: Ensure your FreshBooks connection in Make.com has 'Full Access' permissions, or the 'Create Client' action will return a 403 error. * **Rate Limits**: Clockify's API has a limit of 10 requests per second. If you are bulk-syncing hundreds of entries via an Aggregator, use the 'Sleep' module or set the Scenario 'Max number of cycles' to a lower value to avoid 429 errors. * **Bundle Overhead**: Every time entry consumed by Make.com counts as an operation. For high-volume teams, consider using the 'Array Aggregator' to group entries before sending them to FreshBooks.

- [ ] **Test Run**: Click 'Run Once' and manually stop a timer in Clockify. - [ ] **Check Inspector**: Open the 'Bubble' icon on the Clockify module to ensure `billable: true` is present. - [ ] **Verify Conversion**: Check the FreshBooks Audit Log to ensure 1 hour (3600s) shows as `1.0` and not `3600`. - [ ] **Filter Check**: Create a non-billable entry and verify the scenario correctly ignores it (indicated by a white filter icon). - [ ] **History Tab**: Check the 'History' tab in Make.com to ensure 'Success' status on all operations.