https://focuslasso.com/api/v1{"success":true,"data":…}; errors look like {"success":false,"error":"…","error_code":"…"}.YYYY-MM-DD; times are in the company's time zone.additional_data.pagination.next_cursor back as cursor to get the next page.Personal token (scripts, your own integrations): create one under API & developers and send it as x-api-token.
OAuth 2.0 (apps other companies install): send users to /oauth2.php?action=authorize, swap the code at /oauth2.php?action=token, then send Authorization: Bearer …. Scopes: read write webhooks admin
curl https://focuslasso.com/api/v1/users/me -H "x-api-token: flp_…"
Each token may make 80 calls every 2 seconds (headers X-RateLimit-*). Each company also has a daily budget of units: Lite 30,000, Growth 60,000, Premium 150,000, Ultimate 210,000, per seat. Costs: get 2, list 10, search 20, add/update 10, delete 6 (headers X-Daily-Units-*). Over the limit you get HTTP 429 with Retry-After.
Subscribe with POST /webhooks or in the app. Each delivery is a JSON POST with meta (action, entity, entity_id, changed fields, source), data (the record now) and previous (old values of changed fields). Verify X-FocusLasso-Signature: sha256=HMAC_SHA256(raw body, secret). Retries after 3 s, 30 s and 150 s.
Query: limit (max 500), cursor, ids, owner_id, updated_since, status, pipeline_id, stage_id, person_id, org_id. Results are oldest first; pass additional_data.pagination.next_cursor as cursor for the next page.
curl https://focuslasso.com/api/v1/deals \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/deals/7 \ -H "x-api-token: YOUR_TOKEN"
Unknown keys are ignored. Reference fields take ids. Put custom fields under custom_fields using their keys from /fields/deals.
curl -X POST https://focuslasso.com/api/v1/deals \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title":"Navy CCNA class","value":12000,"person_id":12,"org_id":4,"stage_id":2,"expected_close":"2026-12-15","custom_fields":{"seats":8}}'Send only the fields you want to change. Set "status" to won, lost (with optional lost_reason) or open.
curl -X PATCH https://focuslasso.com/api/v1/deals/7 \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"stage_id":3,"status":"won"}'Needs the Delete permission.
curl -X DELETE https://focuslasso.com/api/v1/deals/7 \ -H "x-api-token: YOUR_TOKEN"
Query: limit (max 500), cursor, ids, owner_id, updated_since, org_id. Results are oldest first; pass additional_data.pagination.next_cursor as cursor for the next page.
curl https://focuslasso.com/api/v1/persons \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/persons/7 \ -H "x-api-token: YOUR_TOKEN"
Unknown keys are ignored. Reference fields take ids. Put custom fields under custom_fields using their keys from /fields/persons.
curl -X POST https://focuslasso.com/api/v1/persons \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Dana Lee","email":"[email protected]","phone":"555-0100","org_id":4}'Send only the fields you want to change.
curl -X PATCH https://focuslasso.com/api/v1/persons/7 \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"owner_id":2}'Needs the Delete permission.
curl -X DELETE https://focuslasso.com/api/v1/persons/7 \ -H "x-api-token: YOUR_TOKEN"
Query: limit (max 500), cursor, ids, owner_id, updated_since. Results are oldest first; pass additional_data.pagination.next_cursor as cursor for the next page.
curl https://focuslasso.com/api/v1/organizations \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/organizations/7 \ -H "x-api-token: YOUR_TOKEN"
Unknown keys are ignored. Reference fields take ids. Put custom fields under custom_fields using their keys from /fields/organizations.
curl -X POST https://focuslasso.com/api/v1/organizations \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Acme Corp","city":"Denver","state":"CO","website":"https://acme.example"}'Send only the fields you want to change.
curl -X PATCH https://focuslasso.com/api/v1/organizations/7 \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"owner_id":2}'Needs the Delete permission.
curl -X DELETE https://focuslasso.com/api/v1/organizations/7 \ -H "x-api-token: YOUR_TOKEN"
Query: limit (max 500), cursor, ids, owner_id, updated_since. Results are oldest first; pass additional_data.pagination.next_cursor as cursor for the next page.
curl https://focuslasso.com/api/v1/leads \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/leads/7 \ -H "x-api-token: YOUR_TOKEN"
Unknown keys are ignored. Reference fields take ids. Put custom fields under custom_fields using their keys from /fields/leads.
curl -X POST https://focuslasso.com/api/v1/leads \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title":"Inbound: Security+ for 6","person_id":12,"value":9000,"source_id":1,"labels":[2]}'Send only the fields you want to change.
curl -X PATCH https://focuslasso.com/api/v1/leads/7 \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"owner_id":2}'Needs the Delete permission.
curl -X DELETE https://focuslasso.com/api/v1/leads/7 \ -H "x-api-token: YOUR_TOKEN"
Query: limit (max 500), cursor, ids, owner_id, updated_since, done, due_from, due_to, deal_id, person_id. Results are oldest first; pass additional_data.pagination.next_cursor as cursor for the next page.
curl https://focuslasso.com/api/v1/activities \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/activities/7 \ -H "x-api-token: YOUR_TOKEN"
Unknown keys are ignored. Reference fields take ids. Put custom fields under custom_fields using their keys from /fields/activities.
curl -X POST https://focuslasso.com/api/v1/activities \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"subject":"Discovery call","type_id":1,"due_date":"2026-11-20","due_time":"14:00","duration_min":30,"deal_id":7}'Send only the fields you want to change.
curl -X PATCH https://focuslasso.com/api/v1/activities/7 \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"owner_id":2}'Needs the Delete permission.
curl -X DELETE https://focuslasso.com/api/v1/activities/7 \ -H "x-api-token: YOUR_TOKEN"
Query: limit (max 500), cursor, ids, owner_id, updated_since. Results are oldest first; pass additional_data.pagination.next_cursor as cursor for the next page.
curl https://focuslasso.com/api/v1/products \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/products/7 \ -H "x-api-token: YOUR_TOKEN"
Unknown keys are ignored. Reference fields take ids. Put custom fields under custom_fields using their keys from /fields/products.
curl -X POST https://focuslasso.com/api/v1/products \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"CCNA Bootcamp","code":"CCNA-5D","price":3495,"billing":"one_time"}'Send only the fields you want to change.
curl -X PATCH https://focuslasso.com/api/v1/products/7 \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"owner_id":2}'Needs the Delete permission.
curl -X DELETE https://focuslasso.com/api/v1/products/7 \ -H "x-api-token: YOUR_TOKEN"
Query: limit (max 500), cursor, ids, owner_id, updated_since. Results are oldest first; pass additional_data.pagination.next_cursor as cursor for the next page.
curl https://focuslasso.com/api/v1/projects \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/projects/7 \ -H "x-api-token: YOUR_TOKEN"
Unknown keys are ignored. Reference fields take ids. Put custom fields under custom_fields using their keys from /fields/projects.
curl -X POST https://focuslasso.com/api/v1/projects \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title":"Onboard Navy cohort","deal_id":7,"start_date":"2026-12-01"}'Send only the fields you want to change.
curl -X PATCH https://focuslasso.com/api/v1/projects/7 \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"owner_id":2}'Needs the Delete permission.
curl -X DELETE https://focuslasso.com/api/v1/projects/7 \ -H "x-api-token: YOUR_TOKEN"
Optional stage_id, title, owner_id.
curl -X POST https://focuslasso.com/api/v1/leads/7/convert \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"stage_id":1}'curl https://focuslasso.com/api/v1/deals/7/products \ -H "x-api-token: YOUR_TOKEN"
The deal value is recalculated.
curl -X POST https://focuslasso.com/api/v1/deals/7/products \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"product_id":3,"qty":2,"discount_pct":10}'curl -X DELETE https://focuslasso.com/api/v1/deals/7/products/3 \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/projects/7/tasks \ -H "x-api-token: YOUR_TOKEN"
curl -X POST https://focuslasso.com/api/v1/projects/7/tasks \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title":"Ship lab kits","due_date":"2026-11-28","assignee_id":2}'Query: entity (deals, persons, …) and record_id.
curl https://focuslasso.com/api/v1/notes \ -H "x-api-token: YOUR_TOKEN"
curl -X POST https://focuslasso.com/api/v1/notes \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"entity":"deals","record_id":7,"body":"Customer wants a December start.","pinned":true}'curl -X DELETE https://focuslasso.com/api/v1/notes/7 \ -H "x-api-token: YOUR_TOKEN"
Query: term (2+ chars), types (comma list), limit per type.
curl https://focuslasso.com/api/v1/search \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/pipelines \ -H "x-api-token: YOUR_TOKEN"
Query: pipeline_id
curl https://focuslasso.com/api/v1/stages \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/users \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/users/me \ -H "x-api-token: YOUR_TOKEN"
entity: deals, persons, organizations, leads, activities, products, projects
curl https://focuslasso.com/api/v1/fields/deals \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/activity_types \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/lead_sources \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/lead_labels \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/loss_reasons \ -H "x-api-token: YOUR_TOKEN"
curl https://focuslasso.com/api/v1/webhooks \ -H "x-api-token: YOUR_TOKEN"
event_object: * deal person organization lead activity product project note. event_action: * added updated deleted. The response includes the signing secret (shown once).
curl -X POST https://focuslasso.com/api/v1/webhooks \
-H "x-api-token: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"subscription_url":"https://example.com/hooks/focuslasso","event_object":"deal","event_action":"*"}'curl https://focuslasso.com/api/v1/webhooks/7/deliveries \ -H "x-api-token: YOUR_TOKEN"
curl -X DELETE https://focuslasso.com/api/v1/webhooks/7 \ -H "x-api-token: YOUR_TOKEN"