[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76EE4SVHSPBR7RNZR5VNE6K":3,"skill-same:01M76EE4SVHSPBR7RNZR5VNE6K":64},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":15,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":33,"commitSha":34,"skillDirectory":35,"forksCount":13,"repositoryHtmlUrl":36,"repositoryHomepageUrl":6,"ownerHtmlUrl":37,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":38,"install":39,"resources":52},"01M76EE4SVHSPBR7RNZR5VNE6K","jobber",null,"Jobber API integration with managed OAuth. Manage clients, jobs, invoices, quotes, properties, and team members for field service businesses.\nUse this skill when users want to create and manage service jobs, clients, quotes, invoices, or access scheduling data.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","meghal86\u002Fstacksignal","meghal86","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F37388715?v=4","01M6CS2EW8SK89GH52R2ZEN8QQ","01M728J5CGY456EETEFG6HJBTM",0,"MIT","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fjobber\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fjobber\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: jobber\ndescription: |\n  Jobber API integration with managed OAuth. Manage clients, jobs, invoices, quotes, properties, and team members for field service businesses.\n  Use this skill when users want to create and manage service jobs, clients, quotes, invoices, or access scheduling data.\n  For other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\n  Requires network access and valid Maton API key.\nmetadata:\n  author: maton\n  version: \"1.0\"\n  clawdbot:\n    emoji: 🧠\n    requires:\n      env:\n        - MATON_API_KEY\n---\n\n# Jobber\n\nAccess the Jobber API with managed OAuth authentication. Manage clients, jobs, invoices, quotes, properties, and team members for field service businesses.\n\n## Quick Start\n\n```bash\n# Get account information\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nquery = '{\"query\": \"{ account { id name } }\"}'\nreq = urllib.request.Request('https:\u002F\u002Fgateway.maton.ai\u002Fjobber\u002Fgraphql', data=query.encode(), method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application\u002Fjson')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n## API Type\n\nJobber uses a **GraphQL API** exclusively. All requests are POST requests to the `\u002Fgraphql` endpoint with a JSON body containing the `query` field.\n\n## Base URL\n\n```\nhttps:\u002F\u002Fgateway.maton.ai\u002Fjobber\u002Fgraphql\n```\n\nThe gateway proxies requests to `api.getjobber.com\u002Fapi\u002Fgraphql` and automatically injects your OAuth token and API version header.\n\n## Authentication\n\nAll requests require the Maton API key in the Authorization header:\n\n```\nAuthorization: Bearer $MATON_API_KEY\n```\n\nThe gateway automatically injects the `X-JOBBER-GRAPHQL-VERSION` header (currently `2025-04-16`).\n\n**Environment Variable:** Set your API key as `MATON_API_KEY`:\n\n```bash\nexport MATON_API_KEY=\"YOUR_API_KEY\"\n```\n\n### Getting Your API Key\n\n1. Sign in or create an account at [maton.ai](https:\u002F\u002Fmaton.ai)\n2. Go to [maton.ai\u002Fsettings](https:\u002F\u002Fmaton.ai\u002Fsettings)\n3. Copy your API key\n\n## Connection Management\n\nManage your Jobber OAuth connections at `https:\u002F\u002Fctrl.maton.ai`.\n\n### List Connections\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections?app=jobber&status=ACTIVE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Create Connection\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'app': 'jobber'}).encode()\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application\u002Fjson')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Get Connection\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections\u002F{connection_id}')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n**Response:**\n```json\n{\n  \"connection\": {\n    \"connection_id\": \"cc61da85-8bf7-4fbc-896b-4e4eb9a5aafd\",\n    \"status\": \"ACTIVE\",\n    \"creation_time\": \"2026-02-07T09:29:19.946291Z\",\n    \"last_updated_time\": \"2026-02-07T09:30:59.990084Z\",\n    \"url\": \"https:\u002F\u002Fconnect.maton.ai\u002F?session_token=...\",\n    \"app\": \"jobber\",\n    \"metadata\": {}\n  }\n}\n```\n\nOpen the returned `url` in a browser to complete OAuth authorization.\n\n### Delete Connection\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections\u002F{connection_id}', method='DELETE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Specifying Connection\n\nIf you have multiple Jobber connections, specify which one to use with the `Maton-Connection` header:\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nquery = '{\"query\": \"{ account { id name } }\"}'\nreq = urllib.request.Request('https:\u002F\u002Fgateway.maton.ai\u002Fjobber\u002Fgraphql', data=query.encode(), method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application\u002Fjson')\nreq.add_header('Maton-Connection', 'cc61da85-8bf7-4fbc-896b-4e4eb9a5aafd')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\nIf omitted, the gateway uses the default (oldest) active connection.\n\n## API Reference\n\n### Account Operations\n\n#### Get Account Information\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ account { id name } }\"\n}\n```\n\n### Client Operations\n\n#### List Clients\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ clients(first: 20) { nodes { id name emails { primary address } phones { primary number } } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\n#### Get Client by ID\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"query($id: EncodedId!) { client(id: $id) { id name emails { primary address } phones { primary number } billingAddress { street city } } }\",\n  \"variables\": { \"id\": \"CLIENT_ID\" }\n}\n```\n\n#### Create Client\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"mutation($input: ClientCreateInput!) { clientCreate(input: $input) { client { id name } userErrors { message path } } }\",\n  \"variables\": {\n    \"input\": {\n      \"firstName\": \"John\",\n      \"lastName\": \"Doe\",\n      \"email\": \"john@example.com\",\n      \"phone\": \"555-1234\"\n    }\n  }\n}\n```\n\n#### Update Client\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"mutation($id: EncodedId!, $input: ClientUpdateInput!) { clientUpdate(clientId: $id, input: $input) { client { id name } userErrors { message path } } }\",\n  \"variables\": {\n    \"id\": \"CLIENT_ID\",\n    \"input\": {\n      \"email\": \"newemail@example.com\"\n    }\n  }\n}\n```\n\n### Job Operations\n\n#### List Jobs\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ jobs(first: 20) { nodes { id title jobNumber jobStatus client { name } } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\n#### Get Job by ID\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"query($id: EncodedId!) { job(id: $id) { id title jobNumber jobStatus instructions client { name } property { address { street city } } } }\",\n  \"variables\": { \"id\": \"JOB_ID\" }\n}\n```\n\n#### Create Job\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"mutation($input: JobCreateInput!) { jobCreate(input: $input) { job { id jobNumber title } userErrors { message path } } }\",\n  \"variables\": {\n    \"input\": {\n      \"clientId\": \"CLIENT_ID\",\n      \"title\": \"Lawn Maintenance\",\n      \"instructions\": \"Weekly lawn care service\"\n    }\n  }\n}\n```\n\n### Invoice Operations\n\n#### List Invoices\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ invoices(first: 20) { nodes { id invoiceNumber subject total invoiceStatus client { name } } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\n#### Get Invoice by ID\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"query($id: EncodedId!) { invoice(id: $id) { id invoiceNumber subject total amountDue invoiceStatus lineItems { nodes { name quantity unitPrice } } } }\",\n  \"variables\": { \"id\": \"INVOICE_ID\" }\n}\n```\n\n#### Create Invoice\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"mutation($input: InvoiceCreateInput!) { invoiceCreate(input: $input) { invoice { id invoiceNumber } userErrors { message path } } }\",\n  \"variables\": {\n    \"input\": {\n      \"clientId\": \"CLIENT_ID\",\n      \"subject\": \"Service Invoice\",\n      \"lineItems\": [\n        {\n          \"name\": \"Lawn Care\",\n          \"quantity\": 1,\n          \"unitPrice\": 75.00\n        }\n      ]\n    }\n  }\n}\n```\n\n### Quote Operations\n\n#### List Quotes\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ quotes(first: 20) { nodes { id quoteNumber title quoteStatus client { name } } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\n#### Create Quote\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"mutation($input: QuoteCreateInput!) { quoteCreate(input: $input) { quote { id quoteNumber } userErrors { message path } } }\",\n  \"variables\": {\n    \"input\": {\n      \"clientId\": \"CLIENT_ID\",\n      \"title\": \"Landscaping Quote\",\n      \"lineItems\": [\n        {\n          \"name\": \"Garden Design\",\n          \"quantity\": 1,\n          \"unitPrice\": 500.00\n        }\n      ]\n    }\n  }\n}\n```\n\n### Property Operations\n\n#### List Properties\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ properties(first: 20) { nodes { id address { street city state postalCode } client { name } } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\n### Request Operations\n\n#### List Requests\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ requests(first: 20) { nodes { id title requestStatus client { name } } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\n### User\u002FTeam Operations\n\n#### List Users\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ users(first: 50) { nodes { id name { full } email { raw } } } }\"\n}\n```\n\n### Custom Field Operations\n\n#### List Custom Fields\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ customFields(first: 50) { nodes { id name fieldType } } }\"\n}\n```\n\n## Pagination\n\nJobber uses Relay-style cursor-based pagination:\n\n```bash\n# First page\nPOST \u002Fjobber\u002Fgraphql\n{\n  \"query\": \"{ clients(first: 20) { nodes { id name } pageInfo { hasNextPage endCursor } } }\"\n}\n\n# Next page using cursor\nPOST \u002Fjobber\u002Fgraphql\n{\n  \"query\": \"{ clients(first: 20, after: \\\"CURSOR_VALUE\\\") { nodes { id name } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\nResponse includes `pageInfo`:\n```json\n{\n  \"data\": {\n    \"clients\": {\n      \"nodes\": [...],\n      \"pageInfo\": {\n        \"hasNextPage\": true,\n        \"endCursor\": \"abc123\"\n      }\n    }\n  }\n}\n```\n\n## Webhooks\n\nJobber supports webhooks for real-time event notifications:\n\n- `CLIENT_CREATE` - New client created\n- `JOB_COMPLETE` - Job marked complete\n- `QUOTE_CREATE` - New quote created\n- `QUOTE_APPROVAL` - Quote approved\n- `REQUEST_CREATE` - New request created\n- `INVOICE_CREATE` - New invoice created\n- `APP_CONNECT` - App connected\n\nWebhooks include HMAC-SHA256 signatures for verification.\n\n## Code Examples\n\n### JavaScript\n\n```javascript\nconst query = `{ clients(first: 10) { nodes { id name emails { address } } } }`;\n\nconst response = await fetch('https:\u002F\u002Fgateway.maton.ai\u002Fjobber\u002Fgraphql', {\n  method: 'POST',\n  headers: {\n    'Authorization': `Bearer ${process.env.MATON_API_KEY}`,\n    'Content-Type': 'application\u002Fjson'\n  },\n  body: JSON.stringify({ query })\n});\n\nconst data = await response.json();\n```\n\n### Python\n\n```python\nimport os\nimport requests\n\nquery = '''\n{\n  clients(first: 10) {\n    nodes { id name emails { address } }\n  }\n}\n'''\n\nresponse = requests.post(\n    'https:\u002F\u002Fgateway.maton.ai\u002Fjobber\u002Fgraphql',\n    headers={\n        'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}',\n        'Content-Type': 'application\u002Fjson'\n    },\n    json={'query': query}\n)\ndata = response.json()\n```\n\n## Notes\n\n- Jobber uses GraphQL exclusively (no REST API)\n- The gateway automatically injects the `X-JOBBER-GRAPHQL-VERSION` header\n- Current gateway API version: `2025-04-16` (latest)\n- Old API versions are supported for 12-18 months from release\n- Use the GraphiQL explorer in Jobber's Developer Center for schema discovery\n- IDs use `EncodedId` type (base64 encoded) - pass as strings\n- Field naming: use `emails`\u002F`phones` (arrays), `jobStatus`\u002F`invoiceStatus`\u002F`quoteStatus`\u002F`requestStatus`\n- Rate limits:\n  - DDoS protection: 2,500 requests per 5 minutes per app\u002Faccount\n  - Query cost: Points-based using leaky bucket algorithm (max 10,000 points, restore 500\u002Fsec)\n- Avoid deeply nested queries to reduce query cost\n- IMPORTANT: When piping curl output to `jq` or other commands, environment variables like `$MATON_API_KEY` may not expand correctly in some shell environments\n\n## Error Handling\n\n| Status | Meaning |\n|--------|---------|\n| 400 | Missing Jobber connection or malformed query |\n| 401 | Invalid or missing Maton API key |\n| 403 | Not authorized (check OAuth scopes) |\n| 429 | Rate limited |\n| 4xx\u002F5xx | Passthrough error from Jobber API |\n\nGraphQL errors appear in the response body:\n```json\n{\n  \"errors\": [\n    {\n      \"message\": \"Error description\",\n      \"locations\": [...],\n      \"path\": [...]\n    }\n  ]\n}\n```\n\nMutation errors appear in `userErrors`:\n```json\n{\n  \"data\": {\n    \"clientCreate\": {\n      \"client\": null,\n      \"userErrors\": [\n        {\n          \"message\": \"Email is required\",\n          \"path\": [\"input\", \"email\"]\n        }\n      ]\n    }\n  }\n}\n```\n\n### Troubleshooting: API Key Issues\n\n1. Check that the `MATON_API_KEY` environment variable is set:\n\n```bash\necho $MATON_API_KEY\n```\n\n2. Verify the API key is valid by listing connections:\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Troubleshooting: Invalid App Name\n\n1. Ensure your URL path starts with `jobber`. For example:\n\n- Correct: `https:\u002F\u002Fgateway.maton.ai\u002Fjobber\u002Fgraphql`\n- Incorrect: `https:\u002F\u002Fgateway.maton.ai\u002Fgraphql`\n\n## Resources\n\n- [Jobber Developer Documentation](https:\u002F\u002Fdeveloper.getjobber.com\u002Fdocs\u002F)\n- [Getting Started Guide](https:\u002F\u002Fdeveloper.getjobber.com\u002Fdocs\u002Fgetting_started\u002F)\n- [API Support](mailto:api-support@getjobber.com)\n- [Maton Community](https:\u002F\u002Fdiscord.com\u002Finvite\u002FdBfFAcefs2)\n- [Maton Support](mailto:support@maton.ai)\n","# Jobber\n\nAccess the Jobber API with managed OAuth authentication. Manage clients, jobs, invoices, quotes, properties, and team members for field service businesses.\n\n## Quick Start\n\n```bash\n# Get account information\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nquery = '{\"query\": \"{ account { id name } }\"}'\nreq = urllib.request.Request('https:\u002F\u002Fgateway.maton.ai\u002Fjobber\u002Fgraphql', data=query.encode(), method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application\u002Fjson')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n## API Type\n\nJobber uses a **GraphQL API** exclusively. All requests are POST requests to the `\u002Fgraphql` endpoint with a JSON body containing the `query` field.\n\n## Base URL\n\n```\nhttps:\u002F\u002Fgateway.maton.ai\u002Fjobber\u002Fgraphql\n```\n\nThe gateway proxies requests to `api.getjobber.com\u002Fapi\u002Fgraphql` and automatically injects your OAuth token and API version header.\n\n## Authentication\n\nAll requests require the Maton API key in the Authorization header:\n\n```\nAuthorization: Bearer $MATON_API_KEY\n```\n\nThe gateway automatically injects the `X-JOBBER-GRAPHQL-VERSION` header (currently `2025-04-16`).\n\n**Environment Variable:** Set your API key as `MATON_API_KEY`:\n\n```bash\nexport MATON_API_KEY=\"YOUR_API_KEY\"\n```\n\n### Getting Your API Key\n\n1. Sign in or create an account at [maton.ai](https:\u002F\u002Fmaton.ai)\n2. Go to [maton.ai\u002Fsettings](https:\u002F\u002Fmaton.ai\u002Fsettings)\n3. Copy your API key\n\n## Connection Management\n\nManage your Jobber OAuth connections at `https:\u002F\u002Fctrl.maton.ai`.\n\n### List Connections\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections?app=jobber&status=ACTIVE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Create Connection\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'app': 'jobber'}).encode()\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application\u002Fjson')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Get Connection\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections\u002F{connection_id}')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n**Response:**\n```json\n{\n  \"connection\": {\n    \"connection_id\": \"cc61da85-8bf7-4fbc-896b-4e4eb9a5aafd\",\n    \"status\": \"ACTIVE\",\n    \"creation_time\": \"2026-02-07T09:29:19.946291Z\",\n    \"last_updated_time\": \"2026-02-07T09:30:59.990084Z\",\n    \"url\": \"https:\u002F\u002Fconnect.maton.ai\u002F?session_token=...\",\n    \"app\": \"jobber\",\n    \"metadata\": {}\n  }\n}\n```\n\nOpen the returned `url` in a browser to complete OAuth authorization.\n\n### Delete Connection\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections\u002F{connection_id}', method='DELETE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Specifying Connection\n\nIf you have multiple Jobber connections, specify which one to use with the `Maton-Connection` header:\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nquery = '{\"query\": \"{ account { id name } }\"}'\nreq = urllib.request.Request('https:\u002F\u002Fgateway.maton.ai\u002Fjobber\u002Fgraphql', data=query.encode(), method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application\u002Fjson')\nreq.add_header('Maton-Connection', 'cc61da85-8bf7-4fbc-896b-4e4eb9a5aafd')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\nIf omitted, the gateway uses the default (oldest) active connection.\n\n## API Reference\n\n### Account Operations\n\n#### Get Account Information\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ account { id name } }\"\n}\n```\n\n### Client Operations\n\n#### List Clients\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ clients(first: 20) { nodes { id name emails { primary address } phones { primary number } } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\n#### Get Client by ID\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"query($id: EncodedId!) { client(id: $id) { id name emails { primary address } phones { primary number } billingAddress { street city } } }\",\n  \"variables\": { \"id\": \"CLIENT_ID\" }\n}\n```\n\n#### Create Client\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"mutation($input: ClientCreateInput!) { clientCreate(input: $input) { client { id name } userErrors { message path } } }\",\n  \"variables\": {\n    \"input\": {\n      \"firstName\": \"John\",\n      \"lastName\": \"Doe\",\n      \"email\": \"john@example.com\",\n      \"phone\": \"555-1234\"\n    }\n  }\n}\n```\n\n#### Update Client\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"mutation($id: EncodedId!, $input: ClientUpdateInput!) { clientUpdate(clientId: $id, input: $input) { client { id name } userErrors { message path } } }\",\n  \"variables\": {\n    \"id\": \"CLIENT_ID\",\n    \"input\": {\n      \"email\": \"newemail@example.com\"\n    }\n  }\n}\n```\n\n### Job Operations\n\n#### List Jobs\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ jobs(first: 20) { nodes { id title jobNumber jobStatus client { name } } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\n#### Get Job by ID\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"query($id: EncodedId!) { job(id: $id) { id title jobNumber jobStatus instructions client { name } property { address { street city } } } }\",\n  \"variables\": { \"id\": \"JOB_ID\" }\n}\n```\n\n#### Create Job\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"mutation($input: JobCreateInput!) { jobCreate(input: $input) { job { id jobNumber title } userErrors { message path } } }\",\n  \"variables\": {\n    \"input\": {\n      \"clientId\": \"CLIENT_ID\",\n      \"title\": \"Lawn Maintenance\",\n      \"instructions\": \"Weekly lawn care service\"\n    }\n  }\n}\n```\n\n### Invoice Operations\n\n#### List Invoices\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ invoices(first: 20) { nodes { id invoiceNumber subject total invoiceStatus client { name } } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\n#### Get Invoice by ID\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"query($id: EncodedId!) { invoice(id: $id) { id invoiceNumber subject total amountDue invoiceStatus lineItems { nodes { name quantity unitPrice } } } }\",\n  \"variables\": { \"id\": \"INVOICE_ID\" }\n}\n```\n\n#### Create Invoice\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"mutation($input: InvoiceCreateInput!) { invoiceCreate(input: $input) { invoice { id invoiceNumber } userErrors { message path } } }\",\n  \"variables\": {\n    \"input\": {\n      \"clientId\": \"CLIENT_ID\",\n      \"subject\": \"Service Invoice\",\n      \"lineItems\": [\n        {\n          \"name\": \"Lawn Care\",\n          \"quantity\": 1,\n          \"unitPrice\": 75.00\n        }\n      ]\n    }\n  }\n}\n```\n\n### Quote Operations\n\n#### List Quotes\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ quotes(first: 20) { nodes { id quoteNumber title quoteStatus client { name } } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\n#### Create Quote\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"mutation($input: QuoteCreateInput!) { quoteCreate(input: $input) { quote { id quoteNumber } userErrors { message path } } }\",\n  \"variables\": {\n    \"input\": {\n      \"clientId\": \"CLIENT_ID\",\n      \"title\": \"Landscaping Quote\",\n      \"lineItems\": [\n        {\n          \"name\": \"Garden Design\",\n          \"quantity\": 1,\n          \"unitPrice\": 500.00\n        }\n      ]\n    }\n  }\n}\n```\n\n### Property Operations\n\n#### List Properties\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ properties(first: 20) { nodes { id address { street city state postalCode } client { name } } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\n### Request Operations\n\n#### List Requests\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ requests(first: 20) { nodes { id title requestStatus client { name } } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\n### User\u002FTeam Operations\n\n#### List Users\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ users(first: 50) { nodes { id name { full } email { raw } } } }\"\n}\n```\n\n### Custom Field Operations\n\n#### List Custom Fields\n\n```bash\nPOST \u002Fjobber\u002Fgraphql\nContent-Type: application\u002Fjson\n\n{\n  \"query\": \"{ customFields(first: 50) { nodes { id name fieldType } } }\"\n}\n```\n\n## Pagination\n\nJobber uses Relay-style cursor-based pagination:\n\n```bash\n# First page\nPOST \u002Fjobber\u002Fgraphql\n{\n  \"query\": \"{ clients(first: 20) { nodes { id name } pageInfo { hasNextPage endCursor } } }\"\n}\n\n# Next page using cursor\nPOST \u002Fjobber\u002Fgraphql\n{\n  \"query\": \"{ clients(first: 20, after: \\\"CURSOR_VALUE\\\") { nodes { id name } pageInfo { hasNextPage endCursor } } }\"\n}\n```\n\nResponse includes `pageInfo`:\n```json\n{\n  \"data\": {\n    \"clients\": {\n      \"nodes\": [...],\n      \"pageInfo\": {\n        \"hasNextPage\": true,\n        \"endCursor\": \"abc123\"\n      }\n    }\n  }\n}\n```\n\n## Webhooks\n\nJobber supports webhooks for real-time event notifications:\n\n- `CLIENT_CREATE` - New client created\n- `JOB_COMPLETE` - Job marked complete\n- `QUOTE_CREATE` - New quote created\n- `QUOTE_APPROVAL` - Quote approved\n- `REQUEST_CREATE` - New request created\n- `INVOICE_CREATE` - New invoice created\n- `APP_CONNECT` - App connected\n\nWebhooks include HMAC-SHA256 signatures for verification.\n\n## Code Examples\n\n### JavaScript\n\n```javascript\nconst query = `{ clients(first: 10) { nodes { id name emails { address } } } }`;\n\nconst response = await fetch('https:\u002F\u002Fgateway.maton.ai\u002Fjobber\u002Fgraphql', {\n  method: 'POST',\n  headers: {\n    'Authorization': `Bearer ${process.env.MATON_API_KEY}`,\n    'Content-Type': 'application\u002Fjson'\n  },\n  body: JSON.stringify({ query })\n});\n\nconst data = await response.json();\n```\n\n### Python\n\n```python\nimport os\nimport requests\n\nquery = '''\n{\n  clients(first: 10) {\n    nodes { id name emails { address } }\n  }\n}\n'''\n\nresponse = requests.post(\n    'https:\u002F\u002Fgateway.maton.ai\u002Fjobber\u002Fgraphql',\n    headers={\n        'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}',\n        'Content-Type': 'application\u002Fjson'\n    },\n    json={'query': query}\n)\ndata = response.json()\n```\n\n## Notes\n\n- Jobber uses GraphQL exclusively (no REST API)\n- The gateway automatically injects the `X-JOBBER-GRAPHQL-VERSION` header\n- Current gateway API version: `2025-04-16` (latest)\n- Old API versions are supported for 12-18 months from release\n- Use the GraphiQL explorer in Jobber's Developer Center for schema discovery\n- IDs use `EncodedId` type (base64 encoded) - pass as strings\n- Field naming: use `emails`\u002F`phones` (arrays), `jobStatus`\u002F`invoiceStatus`\u002F`quoteStatus`\u002F`requestStatus`\n- Rate limits:\n  - DDoS protection: 2,500 requests per 5 minutes per app\u002Faccount\n  - Query cost: Points-based using leaky bucket algorithm (max 10,000 points, restore 500\u002Fsec)\n- Avoid deeply nested queries to reduce query cost\n- IMPORTANT: When piping curl output to `jq` or other commands, environment variables like `$MATON_API_KEY` may not expand correctly in some shell environments\n\n## Error Handling\n\n| Status | Meaning |\n|--------|---------|\n| 400 | Missing Jobber connection or malformed query |\n| 401 | Invalid or missing Maton API key |\n| 403 | Not authorized (check OAuth scopes) |\n| 429 | Rate limited |\n| 4xx\u002F5xx | Passthrough error from Jobber API |\n\nGraphQL errors appear in the response body:\n```json\n{\n  \"errors\": [\n    {\n      \"message\": \"Error description\",\n      \"locations\": [...],\n      \"path\": [...]\n    }\n  ]\n}\n```\n\nMutation errors appear in `userErrors`:\n```json\n{\n  \"data\": {\n    \"clientCreate\": {\n      \"client\": null,\n      \"userErrors\": [\n        {\n          \"message\": \"Email is required\",\n          \"path\": [\"input\", \"email\"]\n        }\n      ]\n    }\n  }\n}\n```\n\n### Troubleshooting: API Key Issues\n\n1. Check that the `MATON_API_KEY` environment variable is set:\n\n```bash\necho $MATON_API_KEY\n```\n\n2. Verify the API key is valid by listing connections:\n\n```bash\npython \u003C\u003C'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https:\u002F\u002Fctrl.maton.ai\u002Fconnections')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n```\n\n### Troubleshooting: Invalid App Name\n\n1. Ensure your URL path starts with `jobber`. For example:\n\n- Correct: `https:\u002F\u002Fgateway.maton.ai\u002Fjobber\u002Fgraphql`\n- Incorrect: `https:\u002F\u002Fgateway.maton.ai\u002Fgraphql`\n\n## Resources\n\n- [Jobber Developer Documentation](https:\u002F\u002Fdeveloper.getjobber.com\u002Fdocs\u002F)\n- [Getting Started Guide](https:\u002F\u002Fdeveloper.getjobber.com\u002Fdocs\u002Fgetting_started\u002F)\n- [API Support](mailto:api-support@getjobber.com)\n- [Maton Community](https:\u002F\u002Fdiscord.com\u002Finvite\u002FdBfFAcefs2)\n- [Maton Support](mailto:support@maton.ai)\n",{"name":5,"metadata":24,"description":32},{"author":25,"version":26,"clawdbot":27},"maton","1.0",{"emoji":28,"requires":29},"🧠",{"env":30},[31],"MATON_API_KEY","Jobber API integration with managed OAuth. Manage clients, jobs, invoices, quotes, properties, and team members for field service businesses.\nUse this skill when users want to create and manage service jobs, clients, quotes, invoices, or access scheduling data.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.\n","main","54afe4b75ed2eb8f0feabb2f5b57dfa4bcbb3c44",".agents\u002Fskills\u002Fjobber","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal","https:\u002F\u002Fgithub.com\u002Fmeghal86","2026-05-17 14:11:28",{"source":8,"skillName":5,"commands":40,"prompt":50,"zipAvailable":51},[41,44,47],{"tool":42,"command":43},"npx","npx skills add meghal86\u002Fstacksignal --skill jobber",{"tool":45,"command":46},"bunx","bunx skills add meghal86\u002Fstacksignal --skill jobber",{"tool":48,"command":49},"pnpm","pnpm dlx skills add meghal86\u002Fstacksignal --skill jobber","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fjobber\u002FSKILL.md",true,[53,59],{"path":54,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":57,"sourceHtmlUrl":58},"_meta.json","REFERENCE","参考文档",444,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fjobber\u002F_meta.json",{"path":60,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":63,"sourceHtmlUrl":15},"LICENSE.txt","LICENSE","许可证",1072,[65,74,82,90,98,105],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":69,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":73},"01M78XH0FRP65NYEDHF2BT7NB1","zvukogram","Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzvukogram\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzvukogram\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":78,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":73},"01M78XEND5ASXYB6MN8AQQGJAF","zohomail","Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels.\nUse this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzohomail\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzohomail\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":86,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":73},"01M78XEBBV3C6DRZFAJXP6RDKS","zoho-recruit","Zoho Recruit API integration with managed OAuth. Manage candidates, job openings, interviews, and recruitment workflows.\nUse this skill when users want to read, create, update, or search recruitment data like candidates, job openings, interviews, and applications in Zoho Recruit.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-recruit\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-recruit\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":94,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":73},"01M78XE5CQG75DZWYSKGXFR99T","zoho-people","Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, and leave.\nUse this skill when users want to read, create, update, or query HR data like employees, departments, designations, and forms in Zoho People.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-people\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-people\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":101,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":73},"01M78XDZKMZAJYFJJFT7MR5ZN2","zoho-mail","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-mail\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-mail\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":109,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":73},"01M78XDST8JK0WVDA1F3VPNWXD","zoho-inventory","Zoho Inventory API integration with managed OAuth. Manage items, sales orders, invoices, purchase orders, bills, contacts, and shipments.\nUse this skill when users want to read, create, update, or delete inventory items, sales orders, invoices, purchase orders, bills, or other inventory records in Zoho Inventory.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-inventory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-inventory\u002FSKILL.md",[],[]]