# Tradify API

> Every Tradify endpoint on Cotlet: inputs, JSON Schema, cURL, Python and Node.js examples and an example response for each call.

Source: https://cotlet.dev/docs/api/tradify

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

15 endpoints for Tradify. Each one is a POST with a JSON body, called with your API key.

- Base URL: `https://cotlet.dev/api/v1/tradify`
- Connects with: Your own Tradify account (an admin or office user for quotes, invoices and the Scheduler)
- Integration page: https://cotlet.dev/integrations/tradify-api-mcp-server

## Endpoints

| Endpoint | Access | Description |
|---|---|---|
| `list_jobs` | read | Jobs with number, customer, site address, status and assigned staff. |
| `get_job` | read | Full job: description, site, tasks, notes, appointments, costs, linked quotes and invoices. |
| `list_customers` | read | Customer profiles with contact details and sites. |
| `list_quotes` | read | Quotes with customer, total, quote date, expiry date and status. |
| `list_invoices` | read | Invoices with customer, job, due date, total, amount paid and amount due. |
| `list_appointments` | read | Scheduler appointments in a date range, with staff, job, times and notes. |
| `create_customer` | write | New customer profile, optionally with a site address. |
| `create_job` | write | New job for a customer. It starts as Unassigned. |
| `update_job_status` | write | Set a manual status on a job, or one of your custom statuses. |
| `create_quote` | write | Draft quote with line items. Nothing is sent until you call send_quote. |
| `send_quote` | write | Approve the quote and email it to the customer with a link to accept or decline online. |
| `create_invoice_from_quote` | write | Draft invoice from an accepted quote, for all of it or part of it. |
| `send_invoice` | write | Approve the invoice and email it to the customer, with payment reminders if enabled. |
| `record_payment` | write | Record a payment received against an invoice. Syncs to your accounting app if connected. |
| `schedule_appointment` | write | Book a job appointment on the Scheduler for staff, optionally emailing the customer a confirmation. |

## List jobs

`POST https://cotlet.dev/api/v1/tradify/list_jobs`

Access: read.

Lists jobs with their number, customer, site address, status and assigned staff. By default it returns active jobs; set status to see to-invoice, on hold, complete or cancelled jobs. Pages hold up to 100 jobs; pass next_cursor back as cursor for the next page.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `status` | enum | no | active, unassigned, assigned, scheduled, in_progress, to_invoice, on_hold, complete or cancelled. Default: active. |
| `customer_id` | string | no | Only jobs for this customer. |
| `search` | string | no | Match job number, customer or description. |
| `limit` | integer | no | 1 to 100. Default: 50. |
| `cursor` | string | no | Next page cursor from the previous call. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/list_jobs \
  -H "Authorization: Bearer $COTLET_API_KEY"
```

**Python**

```python
result = client.call("tradify", "list_jobs")
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'list_jobs');
```

**CLI**

```bash
cotlet call tradify list_jobs
```

### Example response

```json
{
  "jobs": [
    {
      "job_id": "j_20931",
      "number": "J-0418",
      "customer": "Sam Lee",
      "site_address": "12 Oak St",
      "status": "scheduled",
      "staff": [
        "Mike Ross"
      ],
      "description": "Replace hot water cylinder"
    }
  ],
  "next_cursor": null
}
```

## Get job

`POST https://cotlet.dev/api/v1/tradify/get_job`

Access: read.

Returns one job with its description, site, tasks, notes, appointments, costs and the quotes and invoices linked to it. Use it before changing a job so your agent sees its current state.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `job_id` | string | yes | Job ID from list_jobs. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/get_job \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id":"job_8c41d2"}'
```

**Python**

```python
result = client.call("tradify", "get_job", {"job_id":"job_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'get_job', {"job_id":"job_8c41d2"});
```

**CLI**

```bash
cotlet call tradify get_job --data '{"job_id":"job_8c41d2"}'
```

### Example response

```json
{
  "job_id": "j_20931",
  "number": "J-0418",
  "customer": "Sam Lee",
  "site_address": "12 Oak St",
  "status": "scheduled",
  "description": "Replace hot water cylinder",
  "appointments": [
    {
      "staff": [
        "Mike Ross"
      ],
      "start": "2026-10-15T08:00:00+13:00",
      "end": "2026-10-15T12:00:00+13:00"
    }
  ],
  "quotes": [
    "q_90102"
  ],
  "invoices": []
}
```

## List customers

`POST https://cotlet.dev/api/v1/tradify/list_customers`

Access: read.

Lists customer profiles with contact details and sites. Search matches name, email or phone, so your agent can find the customer ID before creating a job or quote.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `search` | string | no | Match name, email or phone. |
| `limit` | integer | no | 1 to 100. Default: 50. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/list_customers \
  -H "Authorization: Bearer $COTLET_API_KEY"
```

**Python**

```python
result = client.call("tradify", "list_customers")
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'list_customers');
```

**CLI**

```bash
cotlet call tradify list_customers
```

### Example response

```json
{
  "customers": [
    {
      "customer_id": "c_48120",
      "name": "Sam Lee",
      "email": "sam@example.com",
      "phone": "021 555 0142",
      "sites": [
        "12 Oak St"
      ]
    }
  ]
}
```

## List quotes

`POST https://cotlet.dev/api/v1/tradify/list_quotes`

Access: read.

Lists quotes with customer, total, quote date, expiry date and status. By default it returns quotes awaiting acceptance; use status accepted with a since date to find quotes accepted in a period.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `status` | enum | no | draft, awaiting_acceptance, accepted, expired or cancelled. Default: awaiting_acceptance. |
| `since` | date | no | Only quotes dated on or after this date. |
| `limit` | integer | no | 1 to 100. Default: 50. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/list_quotes \
  -H "Authorization: Bearer $COTLET_API_KEY"
```

**Python**

```python
result = client.call("tradify", "list_quotes")
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'list_quotes');
```

**CLI**

```bash
cotlet call tradify list_quotes
```

### Example response

```json
{
  "quotes": [
    {
      "quote_id": "q_90314",
      "number": "Q-1042",
      "customer": "Sam Lee",
      "total": "752.10",
      "quote_date": "2026-10-09",
      "expiry_date": "2026-11-09",
      "status": "accepted"
    }
  ]
}
```

## List invoices

`POST https://cotlet.dev/api/v1/tradify/list_invoices`

Access: read.

Lists invoices with customer, job, due date, total, amount paid and amount due. Amount due is total minus amount paid. By default it returns approved invoices; use status overdue to chase late payers.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `status` | enum | no | draft, approved, overdue or paid. Default: approved. |
| `customer_id` | string | no | Only invoices for this customer. |
| `limit` | integer | no | 1 to 100. Default: 50. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/list_invoices \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"overdue"}'
```

**Python**

```python
result = client.call("tradify", "list_invoices", {"status":"overdue"})
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'list_invoices', {"status":"overdue"});
```

**CLI**

```bash
cotlet call tradify list_invoices --data '{"status":"overdue"}'
```

### Example response

```json
{
  "invoices": [
    {
      "invoice_id": "inv_7781",
      "number": "INV-2210",
      "customer": "Priya Patel",
      "job": "J-0402",
      "due_date": "2026-09-30",
      "total": "420.00",
      "paid": "0.00",
      "due": "420.00",
      "status": "overdue"
    },
    {
      "invoice_id": "inv_7790",
      "number": "INV-2219",
      "customer": "Tom Hale",
      "job": "J-0409",
      "due_date": "2026-10-02",
      "total": "980.00",
      "paid": "300.00",
      "due": "680.00",
      "status": "overdue"
    }
  ]
}
```

## List appointments

`POST https://cotlet.dev/api/v1/tradify/list_appointments`

Access: read.

Returns Scheduler appointments between two dates, each with staff, job, start and end times and notes. The range is at most 31 days. Pass staff names to see only those people.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `from` | date | yes | First day. |
| `to` | date | yes | Last day, up to 31 days after from. |
| `staff` | string[] | no | Only these staff members, by name. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/list_appointments \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"2026-10-01","to":"2026-10-01"}'
```

**Python**

```python
result = client.call("tradify", "list_appointments", {"from":"2026-10-01","to":"2026-10-01"})
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'list_appointments', {"from":"2026-10-01","to":"2026-10-01"});
```

**CLI**

```bash
cotlet call tradify list_appointments --data '{"from":"2026-10-01","to":"2026-10-01"}'
```

### Example response

```json
{
  "appointments": [
    {
      "staff": [
        "Mike Ross"
      ],
      "job": "J-0418",
      "start": "2026-10-13T08:00:00+13:00",
      "end": "2026-10-13T12:00:00+13:00",
      "notes": "Bring new cylinder"
    }
  ]
}
```

## Create customer

`POST https://cotlet.dev/api/v1/tradify/create_customer`

Access: write.

Creates a customer profile, optionally with a site address. It reaches no one and stays inside Tradify, so it runs without asking first.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `name` | string | yes | Customer or company name. |
| `email` | string | no | Email for quotes and invoices. |
| `phone` | string | no | Phone number. |
| `address` | string | no | Postal or site address. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/create_customer \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Jane Doe"}'
```

**Python**

```python
result = client.call("tradify", "create_customer", {"name":"Jane Doe"})
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'create_customer', {"name":"Jane Doe"});
```

**CLI**

```bash
cotlet call tradify create_customer --data '{"name":"Jane Doe"}'
```

### Example response

```json
{
  "customer_id": "c_48177",
  "name": "Priya Patel",
  "status": "created"
}
```

## Create job

`POST https://cotlet.dev/api/v1/tradify/create_job`

Access: write.

Creates a job for a customer. The new job starts as Unassigned until an appointment or staff is added. It reaches no one and stays inside Tradify, so it runs without asking first.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `customer_id` | string | yes | Customer ID from list_customers or create_customer. |
| `description` | string | yes | What the work is. |
| `site_address` | string | no | Job address if different from the customer. |
| `reference` | string | no | Your reference, e.g. a PO number. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/create_job \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customer_id":"customer_8c41d2","description":"description"}'
```

**Python**

```python
result = client.call("tradify", "create_job", {"customer_id":"customer_8c41d2","description":"description"})
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'create_job', {"customer_id":"customer_8c41d2","description":"description"});
```

**CLI**

```bash
cotlet call tradify create_job --data '{"customer_id":"customer_8c41d2","description":"description"}'
```

### Example response

```json
{
  "job_id": "j_20931",
  "number": "J-0418",
  "customer": "Sam Lee",
  "site_address": "12 Oak St",
  "description": "Replace hot water cylinder",
  "status": "unassigned"
}
```

## Update job status

`POST https://cotlet.dev/api/v1/tradify/update_job_status`

Access: write.

Sets a manual status on a job: to_invoice, on_hold, complete, cancelled or the name of one of your custom statuses. It reaches no one and one more call sets it back, so it runs without asking first.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `job_id` | string | yes | Job ID from list_jobs. |
| `status` | string | yes | to_invoice, on_hold, complete, cancelled or the name of a custom status. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/update_job_status \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id":"job_8c41d2","status":"status"}'
```

**Python**

```python
result = client.call("tradify", "update_job_status", {"job_id":"job_8c41d2","status":"status"})
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'update_job_status', {"job_id":"job_8c41d2","status":"status"});
```

**CLI**

```bash
cotlet call tradify update_job_status --data '{"job_id":"job_8c41d2","status":"status"}'
```

### Example response

```json
{
  "job_id": "j_20931",
  "status": "complete"
}
```

## Create quote

`POST https://cotlet.dev/api/v1/tradify/create_quote`

Access: write.

Creates a draft quote with line items of type time, misc, price list or kit. Expiry date defaults to your expiry days setting. The quote stays a draft inside Tradify until send_quote, so it runs without asking first.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `customer_id` | string | yes | Customer ID. |
| `line_items` | object | yes | List of items: type (misc, time, price_list or kit), description, quantity, unit price or billing rate. |
| `description` | string | no | Shown on the quote. |
| `expiry_date` | date | no | Default: your expiry days setting. |
| `tax_inclusive` | boolean | no | Prices include tax. Default: false. |
| `job_id` | string | no | Link the quote to an existing job. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/create_quote \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customer_id":"c_48120","description":"Bathroom rewire, 6 downlights and extractor fan","line_items":[{"type":"time","description":"Electrician labour","quantity":6,"billing_rate":"Standard"},{"type":"misc","description":"LED downlights","quantity":6,"unit_price":"24.00"}],"tax_inclusive":false}'
```

**Python**

```python
result = client.call("tradify", "create_quote", {"customer_id":"c_48120","description":"Bathroom rewire, 6 downlights and extractor fan","line_items":[{"type":"time","description":"Electrician labour","quantity":6,"billing_rate":"Standard"},{"type":"misc","description":"LED downlights","quantity":6,"unit_price":"24.00"}],"tax_inclusive":False})
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'create_quote', {"customer_id":"c_48120","description":"Bathroom rewire, 6 downlights and extractor fan","line_items":[{"type":"time","description":"Electrician labour","quantity":6,"billing_rate":"Standard"},{"type":"misc","description":"LED downlights","quantity":6,"unit_price":"24.00"}],"tax_inclusive":false});
```

**CLI**

```bash
cotlet call tradify create_quote --data '{"customer_id":"c_48120","description":"Bathroom rewire, 6 downlights and extractor fan","line_items":[{"type":"time","description":"Electrician labour","quantity":6,"billing_rate":"Standard"},{"type":"misc","description":"LED downlights","quantity":6,"unit_price":"24.00"}],"tax_inclusive":false}'
```

### Example response

```json
{
  "quote_id": "q_90314",
  "number": "Q-1042",
  "status": "draft",
  "customer": "Sam Lee",
  "lines": [
    {
      "description": "Electrician labour",
      "quantity": 6,
      "amount": "510.00"
    },
    {
      "description": "LED downlights",
      "quantity": 6,
      "amount": "144.00"
    }
  ],
  "subtotal": "654.00",
  "tax": "98.10",
  "total": "752.10",
  "expiry_date": "2026-11-09"
}
```

## Send quote

`POST https://cotlet.dev/api/v1/tradify/send_quote`

Access: write. Confirm: waits for the user's OK before it runs.

Approves a draft quote and emails it to the customer with a link to accept or decline online. The email text defaults to your quote email template. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `quote_id` | string | yes | Quote ID from list_quotes. |
| `message` | string | no | Email text. Default: your quote email template. |
| `send_me_a_copy` | boolean | no | Copy to your own email. Default: false. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/send_quote \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"quote_id":"quote_8c41d2"}'
```

**Python**

```python
result = client.call("tradify", "send_quote", {"quote_id":"quote_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'send_quote', {"quote_id":"quote_8c41d2"});
```

**CLI**

```bash
cotlet call tradify send_quote --data '{"quote_id":"quote_8c41d2"}'
```

### Example response

```json
{
  "quote_id": "q_90314",
  "status": "awaiting_acceptance",
  "emailed_to": "sam@example.com"
}
```

## Create invoice from quote

`POST https://cotlet.dev/api/v1/tradify/create_invoice_from_quote`

Access: write.

Creates a draft invoice from an accepted quote. Mode entire invoices everything, remaining invoices what is not yet invoiced, percentage and fixed_amount take amount, and line_items picks lines. The invoice stays a draft until send_invoice, so it runs without asking first.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `quote_id` | string | yes | Quote ID from list_quotes. |
| `mode` | enum | yes | entire, remaining, percentage, fixed_amount or line_items. |
| `amount` | string | no | Percent or fixed amount, for those modes. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/create_invoice_from_quote \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"quote_id":"q_90314","mode":"percentage","amount":"30"}'
```

**Python**

```python
result = client.call("tradify", "create_invoice_from_quote", {"quote_id":"q_90314","mode":"percentage","amount":"30"})
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'create_invoice_from_quote', {"quote_id":"q_90314","mode":"percentage","amount":"30"});
```

**CLI**

```bash
cotlet call tradify create_invoice_from_quote --data '{"quote_id":"q_90314","mode":"percentage","amount":"30"}'
```

### Example response

```json
{
  "invoice_id": "inv_7802",
  "number": "INV-2231",
  "quote_id": "q_90314",
  "status": "draft",
  "total": "225.63"
}
```

## Send invoice

`POST https://cotlet.dev/api/v1/tradify/send_invoice`

Access: write. Confirm: waits for the user's OK before it runs.

Approves a draft invoice and emails it to the customer, with payment reminders if you enabled them. The email text defaults to your invoice email template. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `invoice_id` | string | yes | Invoice ID from list_invoices. |
| `message` | string | no | Email text. Default: your invoice email template. |
| `send_me_a_copy` | boolean | no | Copy to your own email. Default: false. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/send_invoice \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"invoice_id":"invoice_8c41d2"}'
```

**Python**

```python
result = client.call("tradify", "send_invoice", {"invoice_id":"invoice_8c41d2"})
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'send_invoice', {"invoice_id":"invoice_8c41d2"});
```

**CLI**

```bash
cotlet call tradify send_invoice --data '{"invoice_id":"invoice_8c41d2"}'
```

### Example response

```json
{
  "invoice_id": "inv_7802",
  "status": "approved",
  "emailed_to": "sam@example.com"
}
```

## Record payment

`POST https://cotlet.dev/api/v1/tradify/record_payment`

Access: write. Confirm: waits for the user's OK before it runs.

Records a payment received against an invoice and reduces the amount due. If your accounting app is connected, the payment syncs to it. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `invoice_id` | string | yes | Invoice ID from list_invoices. |
| `amount` | string | yes | Amount received. |
| `date` | date | no | Payment date. Default: today. |
| `method` | string | no | Payment method name from your settings. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/record_payment \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"invoice_id":"invoice_8c41d2","amount":"amount"}'
```

**Python**

```python
result = client.call("tradify", "record_payment", {"invoice_id":"invoice_8c41d2","amount":"amount"})
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'record_payment', {"invoice_id":"invoice_8c41d2","amount":"amount"});
```

**CLI**

```bash
cotlet call tradify record_payment --data '{"invoice_id":"invoice_8c41d2","amount":"amount"}'
```

### Example response

```json
{
  "invoice_id": "inv_7781",
  "payment_id": "pay_5530",
  "amount": "420.00",
  "date": "2026-10-11",
  "method": "Bank transfer",
  "due": "0.00",
  "status": "paid"
}
```

## Schedule appointment

`POST https://cotlet.dev/api/v1/tradify/schedule_appointment`

Access: write. Confirm: waits for the user's OK before it runs.

Books a job appointment on the Scheduler for the staff you name; with no staff the appointment is unassigned. Set email_customer to send the customer a confirmation, otherwise nothing is emailed. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `job_id` | string | yes | Job ID from list_jobs. |
| `start` | datetime | yes | ISO 8601 with time zone. |
| `end` | datetime | yes | ISO 8601 with time zone. |
| `staff` | string[] | no | Staff member names. Empty: unassigned appointment. |
| `notes` | string | no | Notes for the crew. |
| `email_customer` | boolean | no | Send the customer an email confirmation. Default: false. |

### Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/tradify/schedule_appointment \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id":"j_20931","start":"2026-10-15T09:30:00+13:00","end":"2026-10-15T13:30:00+13:00","staff":["Mike Ross"],"notes":"Bring 180 L cylinder","email_customer":true}'
```

**Python**

```python
result = client.call("tradify", "schedule_appointment", {"job_id":"j_20931","start":"2026-10-15T09:30:00+13:00","end":"2026-10-15T13:30:00+13:00","staff":["Mike Ross"],"notes":"Bring 180 L cylinder","email_customer":True})
```

**Node.js**

```js
const result = await cotlet.call('tradify', 'schedule_appointment', {"job_id":"j_20931","start":"2026-10-15T09:30:00+13:00","end":"2026-10-15T13:30:00+13:00","staff":["Mike Ross"],"notes":"Bring 180 L cylinder","email_customer":true});
```

**CLI**

```bash
cotlet call tradify schedule_appointment --data '{"job_id":"j_20931","start":"2026-10-15T09:30:00+13:00","end":"2026-10-15T13:30:00+13:00","staff":["Mike Ross"],"notes":"Bring 180 L cylinder","email_customer":true}'
```

### Example response

```json
{
  "appointment_id": "ap_3318",
  "job_id": "j_20931",
  "staff": [
    "Mike Ross"
  ],
  "start": "2026-10-15T08:00:00+13:00",
  "end": "2026-10-15T12:00:00+13:00",
  "customer_emailed": false
}
```