FocusLasso API v1

Basics

  • Base address: https://focuslasso.com/api/v1
  • Send and receive JSON. Every reply looks like {"success":true,"data":…}; errors look like {"success":false,"error":"…","error_code":"…"}.
  • Dates are YYYY-MM-DD; times are in the company's time zone.
  • Lists return up to 500 items, oldest first. Pass additional_data.pagination.next_cursor back as cursor to get the next page.
  • The API sees exactly what the token's user can see, and follows their permission set.

Authentication

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_…"

Rate limits

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.

Webhooks

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.

Endpoints

GET/dealsList Dealsread

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"
GET/deals/{id}Get one Dealread
curl https://focuslasso.com/api/v1/deals/7 \
  -H "x-api-token: YOUR_TOKEN"
POST/dealsAdd a Dealwrite

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}}'
PATCH/deals/{id}Update a Dealwrite

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"}'
DELETE/deals/{id}Delete a Dealwrite

Needs the Delete permission.

curl -X DELETE https://focuslasso.com/api/v1/deals/7 \
  -H "x-api-token: YOUR_TOKEN"
GET/personsList Personsread

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"
GET/persons/{id}Get one Personread
curl https://focuslasso.com/api/v1/persons/7 \
  -H "x-api-token: YOUR_TOKEN"
POST/personsAdd a Personwrite

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}'
PATCH/persons/{id}Update a Personwrite

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}'
DELETE/persons/{id}Delete a Personwrite

Needs the Delete permission.

curl -X DELETE https://focuslasso.com/api/v1/persons/7 \
  -H "x-api-token: YOUR_TOKEN"
GET/organizationsList Organizationsread

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"
GET/organizations/{id}Get one Organizationread
curl https://focuslasso.com/api/v1/organizations/7 \
  -H "x-api-token: YOUR_TOKEN"
POST/organizationsAdd a Organizationwrite

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"}'
PATCH/organizations/{id}Update a Organizationwrite

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}'
DELETE/organizations/{id}Delete a Organizationwrite

Needs the Delete permission.

curl -X DELETE https://focuslasso.com/api/v1/organizations/7 \
  -H "x-api-token: YOUR_TOKEN"
GET/leadsList Leadsread

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"
GET/leads/{id}Get one Leadread
curl https://focuslasso.com/api/v1/leads/7 \
  -H "x-api-token: YOUR_TOKEN"
POST/leadsAdd a Leadwrite

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]}'
PATCH/leads/{id}Update a Leadwrite

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}'
DELETE/leads/{id}Delete a Leadwrite

Needs the Delete permission.

curl -X DELETE https://focuslasso.com/api/v1/leads/7 \
  -H "x-api-token: YOUR_TOKEN"
GET/activitiesList Activitysread

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"
GET/activities/{id}Get one Activityread
curl https://focuslasso.com/api/v1/activities/7 \
  -H "x-api-token: YOUR_TOKEN"
POST/activitiesAdd a Activitywrite

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}'
PATCH/activities/{id}Update a Activitywrite

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}'
DELETE/activities/{id}Delete a Activitywrite

Needs the Delete permission.

curl -X DELETE https://focuslasso.com/api/v1/activities/7 \
  -H "x-api-token: YOUR_TOKEN"
GET/productsList Productsread

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"
GET/products/{id}Get one Productread
curl https://focuslasso.com/api/v1/products/7 \
  -H "x-api-token: YOUR_TOKEN"
POST/productsAdd a Productwrite

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"}'
PATCH/products/{id}Update a Productwrite

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}'
DELETE/products/{id}Delete a Productwrite

Needs the Delete permission.

curl -X DELETE https://focuslasso.com/api/v1/products/7 \
  -H "x-api-token: YOUR_TOKEN"
GET/projectsList Projectsread

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"
GET/projects/{id}Get one Projectread
curl https://focuslasso.com/api/v1/projects/7 \
  -H "x-api-token: YOUR_TOKEN"
POST/projectsAdd a Projectwrite

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"}'
PATCH/projects/{id}Update a Projectwrite

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}'
DELETE/projects/{id}Delete a Projectwrite

Needs the Delete permission.

curl -X DELETE https://focuslasso.com/api/v1/projects/7 \
  -H "x-api-token: YOUR_TOKEN"
POST/leads/{id}/convertConvert a lead to a dealwrite

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}'
GET/deals/{id}/productsList products on a dealread
curl https://focuslasso.com/api/v1/deals/7/products \
  -H "x-api-token: YOUR_TOKEN"
POST/deals/{id}/productsAdd a product to a dealwrite

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}'
DELETE/deals/{id}/products/{line_id}Remove a product line from a dealwrite
curl -X DELETE https://focuslasso.com/api/v1/deals/7/products/3 \
  -H "x-api-token: YOUR_TOKEN"
GET/projects/{id}/tasksList project tasksread
curl https://focuslasso.com/api/v1/projects/7/tasks \
  -H "x-api-token: YOUR_TOKEN"
POST/projects/{id}/tasksAdd a project taskwrite
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}'
GET/notesList notes on a recordread

Query: entity (deals, persons, …) and record_id.

curl https://focuslasso.com/api/v1/notes \
  -H "x-api-token: YOUR_TOKEN"
POST/notesAdd a notewrite
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}'
DELETE/notes/{id}Delete a notewrite
curl -X DELETE https://focuslasso.com/api/v1/notes/7 \
  -H "x-api-token: YOUR_TOKEN"
GET/searchSearch recordsread

Query: term (2+ chars), types (comma list), limit per type.

curl https://focuslasso.com/api/v1/search \
  -H "x-api-token: YOUR_TOKEN"
GET/pipelinesList pipelines with their stagesread
curl https://focuslasso.com/api/v1/pipelines \
  -H "x-api-token: YOUR_TOKEN"
GET/stagesList stagesread

Query: pipeline_id

curl https://focuslasso.com/api/v1/stages \
  -H "x-api-token: YOUR_TOKEN"
GET/usersList usersread
curl https://focuslasso.com/api/v1/users \
  -H "x-api-token: YOUR_TOKEN"
GET/users/meThe user the token belongs toread
curl https://focuslasso.com/api/v1/users/me \
  -H "x-api-token: YOUR_TOKEN"
GET/fields/{entity}List standard and custom fieldsread

entity: deals, persons, organizations, leads, activities, products, projects

curl https://focuslasso.com/api/v1/fields/deals \
  -H "x-api-token: YOUR_TOKEN"
GET/activity_typesList activity typesread
curl https://focuslasso.com/api/v1/activity_types \
  -H "x-api-token: YOUR_TOKEN"
GET/lead_sourcesList lead sourcesread
curl https://focuslasso.com/api/v1/lead_sources \
  -H "x-api-token: YOUR_TOKEN"
GET/lead_labelsList lead labelsread
curl https://focuslasso.com/api/v1/lead_labels \
  -H "x-api-token: YOUR_TOKEN"
GET/loss_reasonsList lost reasonsread
curl https://focuslasso.com/api/v1/loss_reasons \
  -H "x-api-token: YOUR_TOKEN"
GET/webhooksList webhookswebhooks
curl https://focuslasso.com/api/v1/webhooks \
  -H "x-api-token: YOUR_TOKEN"
POST/webhooksSubscribe to changeswebhooks

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":"*"}'
GET/webhooks/{id}/deliveriesRecent delivery attemptswebhooks
curl https://focuslasso.com/api/v1/webhooks/7/deliveries \
  -H "x-api-token: YOUR_TOKEN"
DELETE/webhooks/{id}Delete a webhookwebhooks
curl -X DELETE https://focuslasso.com/api/v1/webhooks/7 \
  -H "x-api-token: YOUR_TOKEN"