Deals & BD Pipeline
Tools for managing the deals pipeline — tracking business development opportunities, client relationships, and revenue.
Workflow
- Discover pipelines:
loxo_list_deal_workflows— find which deal pipelines exist and their IDs - Explore stages:
loxo_get_deal_workflow— get pipeline stage IDs for a specific workflow - Search deals:
loxo_search_deals— find existing deals by query or owner - View detail:
loxo_get_deal— get full details of a specific deal - Create deals:
loxo_create_deal— create a new deal in a pipeline stage - Log activity:
loxo_log_deal_activity— record activities against a deal
Activity types
Deal activity types are separate from candidate activity types. To get deal-specific types (e.g. "Deal Won", "New Lead", "Terms Signed"):
- Get the deal's workflow ID from
loxo_list_deal_workflows - Pass it to
loxo_get_activity_typeswithworkflow_id
Calling loxo_get_activity_types without workflow_id returns candidate activity types.
Tools
loxo_list_deal_workflows
List all deal workflows (pipelines).
Parameters: None required. Optional: response_format.
loxo_get_deal_workflow
Get a deal workflow with its pipeline stages.
Parameters:
id(required) — deal workflow ID
loxo_search_deals
Search and list deals.
Parameters:
query— Lucene query stringowner_emails— array of owner email addresses to filter byscroll_id— pagination cursor from previous search
loxo_get_deal
Get full details of a single deal.
Parameters:
id(required) — deal ID
loxo_create_deal
Create a new deal in a pipeline.
Parameters:
name(required) — deal nameamount(required) — deal valuecloses_at(required) — expected close date (ISO datetime)workflow_id(required) — pipeline ID fromloxo_list_deal_workflowspipeline_stage_id(required) — stage ID fromloxo_get_deal_workflowowner_email— owner's email; falls back toLOXO_DEFAULT_OWNER_EMAILenv varcompany_id— link to a companyperson_id— link to a person/contactjob_id— link to a job
loxo_log_deal_activity
Log an activity on a deal.
Parameters:
deal_id(required) — deal IDactivity_type_id(required) — useloxo_get_activity_typeswithworkflow_idto find valid IDsnotes— optional notes
Configuration
Set LOXO_DEFAULT_OWNER_EMAIL in your .env file to avoid passing owner_email on every loxo_create_deal call:
LOXO_DEFAULT_OWNER_EMAIL=owner@example.comFind valid emails via loxo_list_users.