Bark API

POST https://cotlet.dev/api/v1/bark/list_leads

Returns the leads Bark matched to your services and locations, newest first by default. Each item has the credit cost and signals such as urgent, so you can decide before you spend anything. Reading a list spends no credits and notifies no customer.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/bark/list_leads \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"view":"first_to_respond","service":"Web Design","max_credits":15,"since":"2026-10-12","sort":"credits","limit":20}'

result = client.call("bark", "list_leads", {"view":"first_to_respond","service":"Web Design","max_credits":15,"since":"2026-10-12","sort":"credits","limit":20})

const result = await cotlet.call('bark', 'list_leads', {"view":"first_to_respond","service":"Web Design","max_credits":15,"since":"2026-10-12","sort":"credits","limit":20});

cotlet call bark list_leads --data '{"view":"first_to_respond","service":"Web Design","max_credits":15,"since":"2026-10-12","sort":"credits","limit":20}'

Example response

{
  "leads": [
    {
      "lead_id": "61842207",
      "service": "Wedding Photography",
      "location": "Leeds, LS1",
      "credits": 12,
      "signals": [
        "urgent"
      ],
      "submitted": "2026-10-11"
    },
    {
      "lead_id": "61841930",
      "service": "Web Design",
      "location": "Manchester, M1",
      "credits": 9,
      "signals": [
        "first_to_respond"
      ],
      "submitted": "2026-10-11"
    }
  ]
}

POST https://cotlet.dev/api/v1/bark/get_lead

Returns the full request before you buy it: the customer's answers, location, credit cost, how many professionals have responded and the signals Bark shows. The customer's contact details stay hidden until contact_lead. Read only: no credits are spent.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/bark/get_lead \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lead_id":"lead_8c41d2"}'

result = client.call("bark", "get_lead", {"lead_id":"lead_8c41d2"})

const result = await cotlet.call('bark', 'get_lead', {"lead_id":"lead_8c41d2"});

cotlet call bark get_lead --data '{"lead_id":"lead_8c41d2"}'

Example response

{
  "lead_id": "61842207",
  "service": "Wedding Photography",
  "location": "Leeds, LS1",
  "credits": 12,
  "responses_so_far": 2,
  "signals": [
    "urgent",
    "verified_phone"
  ],
  "answers": {
    "Event date": "2027-06-12",
    "Hours of coverage": "Full day"
  }
}

POST https://cotlet.dev/api/v1/bark/list_responses

Returns the leads you contacted, as in My Responses, with their status, the customer's contact details and your notes. Use status to see only the open ones. Read only.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/bark/list_responses \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("bark", "list_responses")

const result = await cotlet.call('bark', 'list_responses');

cotlet call bark list_responses

Example response

{
  "responses": [
    {
      "lead_id": "61842207",
      "service": "Wedding Photography",
      "customer": "Jordan",
      "status": "pending",
      "contacted": "2026-10-11",
      "note": "Sent estimate"
    },
    {
      "lead_id": "61790415",
      "service": "Kitchen Fitting",
      "customer": "Sam",
      "status": "pending",
      "contacted": "2026-10-08",
      "note": ""
    }
  ]
}

POST https://cotlet.dev/api/v1/bark/get_response

Returns one contacted lead with the customer's name, phone and email, the original request, the estimate you sent and the current status. Read only.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/bark/get_response \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lead_id":"lead_8c41d2"}'

result = client.call("bark", "get_response", {"lead_id":"lead_8c41d2"})

const result = await cotlet.call('bark', 'get_response', {"lead_id":"lead_8c41d2"});

cotlet call bark get_response --data '{"lead_id":"lead_8c41d2"}'

Example response

{
  "lead_id": "61842207",
  "status": "pending",
  "service": "Wedding Photography",
  "customer": {
    "name": "Jordan",
    "email": "client@example.com",
    "phone": "+44 7700 900123"
  },
  "estimate": {
    "amount": "450",
    "message": "Full day coverage, edited gallery included."
  }
}

POST https://cotlet.dev/api/v1/bark/get_credit_balance

Returns the credits available on your account now, as My Credits shows them. Read only.

Parameters

No parameters.

Request

curl -X POST https://cotlet.dev/api/v1/bark/get_credit_balance \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("bark", "get_credit_balance")

const result = await cotlet.call('bark', 'get_credit_balance');

cotlet call bark get_credit_balance

Example response

{
  "credits": 88
}

POST https://cotlet.dev/api/v1/bark/list_invoices

Returns your Bark invoices with date, amount and a download link. Use since to limit the range. Read only.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/bark/list_invoices \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("bark", "list_invoices")

const result = await cotlet.call('bark', 'list_invoices');

cotlet call bark list_invoices

Example response

{
  "invoices": [
    {
      "invoice_id": "INV-2026-0914",
      "date": "2026-09-14",
      "amount": "50.00",
      "download_url": "https://www.bark.com/invoices/example-0914.pdf"
    },
    {
      "invoice_id": "INV-2026-1002",
      "date": "2026-10-02",
      "amount": "100.00",
      "download_url": "https://www.bark.com/invoices/example-1002.pdf"
    }
  ]
}

POST https://cotlet.dev/api/v1/bark/get_lead_preferences

Returns the services, locations and coverage areas that decide which leads Bark sends you, from Lead Preferences in Settings. Read only.

Parameters

No parameters.

Request

curl -X POST https://cotlet.dev/api/v1/bark/get_lead_preferences \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("bark", "get_lead_preferences")

const result = await cotlet.call('bark', 'get_lead_preferences');

cotlet call bark get_lead_preferences

Example response

{
  "services": [
    "Web Design",
    "Wedding Photography"
  ],
  "locations": [
    {
      "place": "Leeds",
      "radius_miles": 25
    }
  ]
}

POST https://cotlet.dev/api/v1/bark/add_note

Adds a private note to a contacted lead. The customer is not told, so this tool does not ask for your OK, and you can change the note with another call.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/bark/add_note \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lead_id":"lead_8c41d2","note":"note"}'

result = client.call("bark", "add_note", {"lead_id":"lead_8c41d2","note":"note"})

const result = await cotlet.call('bark', 'add_note', {"lead_id":"lead_8c41d2","note":"note"});

cotlet call bark add_note --data '{"lead_id":"lead_8c41d2","note":"note"}'

Example response

{
  "lead_id": "61842207",
  "note": "Wants a second shooter",
  "saved": true
}

POST https://cotlet.dev/api/v1/bark/update_response_status

Moves a contacted lead to pending, hired or archived and returns the new status. A lead must be hired before request_review works. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/bark/update_response_status \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lead_id":"lead_8c41d2","status":"pending"}'

result = client.call("bark", "update_response_status", {"lead_id":"lead_8c41d2","status":"pending"})

const result = await cotlet.call('bark', 'update_response_status', {"lead_id":"lead_8c41d2","status":"pending"});

cotlet call bark update_response_status --data '{"lead_id":"lead_8c41d2","status":"pending"}'

Example response

{
  "lead_id": "61790415",
  "status": "hired"
}

POST https://cotlet.dev/api/v1/bark/contact_lead

Spends credits to contact the lead and returns the customer's name, phone and email. Bark notifies the customer. Set max_credits and the call fails instead of buying a lead that costs more. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/bark/contact_lead \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lead_id":"61842207","max_credits":15}'

result = client.call("bark", "contact_lead", {"lead_id":"61842207","max_credits":15})

const result = await cotlet.call('bark', 'contact_lead', {"lead_id":"61842207","max_credits":15});

cotlet call bark contact_lead --data '{"lead_id":"61842207","max_credits":15}'

Example response

{
  "lead_id": "61842207",
  "status": "pending",
  "credits_spent": 12,
  "credits_left": 88,
  "service": "Wedding Photography",
  "location": "Leeds, LS1",
  "customer": {
    "name": "Jordan",
    "email": "client@example.com",
    "phone": "+44 7700 900123"
  }
}

POST https://cotlet.dev/api/v1/bark/skip_lead

Marks the lead Not interested. No credits are charged, and Bark tells the customer politely. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/bark/skip_lead \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lead_id":"lead_8c41d2"}'

result = client.call("bark", "skip_lead", {"lead_id":"lead_8c41d2"})

const result = await cotlet.call('bark', 'skip_lead', {"lead_id":"lead_8c41d2"});

cotlet call bark skip_lead --data '{"lead_id":"lead_8c41d2"}'

Example response

{
  "lead_id": "61841930",
  "status": "skipped",
  "credits_spent": 0
}

POST https://cotlet.dev/api/v1/bark/send_estimate

Sends a quote on a lead you already contacted. Bark notifies the customer. The amount is in your Bark currency. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/bark/send_estimate \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lead_id":"lead_8c41d2","amount":"amount"}'

result = client.call("bark", "send_estimate", {"lead_id":"lead_8c41d2","amount":"amount"})

const result = await cotlet.call('bark', 'send_estimate', {"lead_id":"lead_8c41d2","amount":"amount"});

cotlet call bark send_estimate --data '{"lead_id":"lead_8c41d2","amount":"amount"}'

Example response

{
  "lead_id": "61842207",
  "amount": "450",
  "message": "Full day coverage, edited gallery included.",
  "sent": true
}

POST https://cotlet.dev/api/v1/bark/send_message

Emails or texts a customer you already contacted, as free text in body or from one of your saved Email or SMS templates. Required: body or template. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/bark/send_message \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lead_id":"61842207","channel":"sms","template":"Follow-up"}'

result = client.call("bark", "send_message", {"lead_id":"61842207","channel":"sms","template":"Follow-up"})

const result = await cotlet.call('bark', 'send_message', {"lead_id":"61842207","channel":"sms","template":"Follow-up"});

cotlet call bark send_message --data '{"lead_id":"61842207","channel":"sms","template":"Follow-up"}'

Example response

{
  "lead_id": "61842207",
  "channel": "sms",
  "sent": true
}

POST https://cotlet.dev/api/v1/bark/request_review

Invites the customer to review you on Bark. The lead must be marked hired first, otherwise the call fails. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/bark/request_review \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lead_id":"lead_8c41d2"}'

result = client.call("bark", "request_review", {"lead_id":"lead_8c41d2"})

const result = await cotlet.call('bark', 'request_review', {"lead_id":"lead_8c41d2"});

cotlet call bark request_review --data '{"lead_id":"lead_8c41d2"}'

Example response

{
  "lead_id": "61790415",
  "review_requested": true
}