Jobtread Api

What This Skill Does

The JobTread API skill for OpenClaw enables seamless, programmatic interaction with your JobTread construction management environment. By leveraging the Pave Query API, this skill allows users to automate complex project workflows, customer relationship management, and data retrieval directly through an AI interface. It acts as a bridge between OpenClaw and the JobTread ecosystem, supporting actions such as creating customer or vendor profiles, managing jobs, retrieving document data, and tracking task progress. Every request is structured as a JSON-based Pave query, giving the user granular control over the specific data fields they want to retrieve or modify.

Installation

To integrate this skill, ensure you have the OpenClaw environment properly initialized. Execute the installation command in your terminal: clawhub install openclaw/skills/skills/brokenwatch24/jobtread-api. After installation, you must secure your credentials. Obtain a grantKey from the JobTread app settings and store it in ~/.config/jobtread/grant_key with strict permissions (chmod 600). This ensures your API authentication remains isolated and secure.

Use Cases

• Client Onboarding: Automatically create new customer profiles in JobTread when a lead signs a contract in an external CRM or form system.
• Automated Reporting: Generate daily or weekly summaries of project tasks, budget status, and document updates across multiple job sites.
• Vendor Synchronization: Bulk import or update vendor contact and payment details to ensure consistency across your organization.
• Event-Driven Workflows: Utilize webhook integration to trigger internal notifications or update database records immediately when a job milestone is marked complete.

Example Prompts

1. "OpenClaw, find the organization ID for my current JobTread grant and list the last five customers created."
2. "Create a new vendor named 'Reliable Plumbing' in my JobTread account with the type set to 'vendor' under my organization."
3. "Summarize the status of all active tasks for the current job, ensuring you fetch the task name and completion status."

Tips & Limitations

• Grant Rotation: JobTread keys expire after three months. Create a recurring calendar reminder to rotate your grantKey to prevent service disruptions.
• Data Integrity: Always include the id field in your queries if you intend to perform follow-up operations or edits, as this is the primary key for referencing objects.
• Security: Use the notify and viaUserId parameters in your Pave queries to control whether your actions trigger push notifications or appear as specific user activities within the JobTread logs. Avoid hardcoding your grant key directly into prompt strings; use the local file storage method provided.