addPipelineEntriesToRoom
ChatGPTAttach one or more existing pipeline entries (leads) to a lead room Joel Pilger API POST /api/v1/lead-rooms/{id}/pipeline-entries.
authMe
ChatGPTSession details (Clerk id + local user when resolved) Joel Pilger API GET /api/v1/auth/me.
createCenterfile
ChatGPTCreate a new Centerfile (Centerfile Copilot sync) Called by the Centerfile Copilot GPT after the user confirms a draft. content is a free-form JSON object whose keys are v3.0 section names. Sales Scout stores it opaquely. Joel Pilger API POST /api/v1/me/centerfiles.
createLead
ChatGPTCreate a new lead (pipeline entry) Structured write. Scout MUST confirm the payload with the user before calling. Resolve ownedByUserId via GET /pipeline/assignable-users. Enum values are case-sensitive. Joel Pilger API POST /api/v1/pipeline.
createLeadRoom
ChatGPTCreate a lead room (with initial pipeline entries and optional linked chats) Joel Pilger API POST /api/v1/lead-rooms.
createLeadRoomTask
ChatGPTAdd a checklist task to a lead room Joel Pilger API POST /api/v1/lead-rooms/{id}/tasks.
createLinkedChat
ChatGPTLog a GPT chat (ChatGPT URL) against a lead room Joel Pilger API POST /api/v1/lead-rooms/{id}/linked-chats.
crm_connection_status
ChatGPTCheck the user's CRM connection status (call before other crm_ tools) Returns the active CRM connection (or null when the user has not connected a CRM). If null or status is not CONNECTED, tell the user to connect their CRM in Sales Scout → Settings → CRM Integrations, and do not call other crm_ tools. Joel Pilger API GET /api/v1/crm/connection.
crm_create_note
ChatGPTCreate a note in the CRM (preview + confirm first) Joel Pilger API POST /api/v1/crm/notes.
crm_create_record
ChatGPTCreate a CRM record with full fields (preview + confirm first) Never name-only when more context exists. Resolve companyId, primaryContactId, pipelineId, stageId, ownerId first. Pass full CrmWriteFields. Optional note+task on the same create. Preview exact JSON, one yes, then call. Joel Pilger API POST /api/v1/crm/records.
crm_create_records
ChatGPTCreate up to 10 CRM records in one call (one preview, one confirm) Bulk create (max 10). Preview items[] once, one yes, then call once. Resolve/create companies first so people include companyId. Partial success — do not retry ok indexes. Joel Pilger API POST /api/v1/crm/records/batch.
crm_create_task
ChatGPTCreate a task in the CRM (preview + confirm first) Joel Pilger API POST /api/v1/crm/tasks.
crm_get_activities
ChatGPTList activities on a CRM record Joel Pilger API GET /api/v1/crm/records/{entityType}/{id}/activities.
crm_get_notes
ChatGPTList notes on a CRM record Joel Pilger API GET /api/v1/crm/records/{entityType}/{id}/notes.
crm_get_record
ChatGPTRetrieve a single CRM record (company, person, lead, opportunity) Joel Pilger API GET /api/v1/crm/records/{entityType}/{id}.
crm_get_tasks
ChatGPTList tasks on a CRM record Joel Pilger API GET /api/v1/crm/records/{entityType}/{id}/tasks.
crm_list_pipelines
ChatGPTList CRM pipelines and their stages Joel Pilger API GET /api/v1/crm/pipelines.
crm_list_stages
ChatGPTList CRM pipeline stages (optionally filtered by pipelineId) Joel Pilger API GET /api/v1/crm/stages.
crm_list_users
ChatGPTList CRM users (resolve ownerId for creates/updates) Returns CRM users so you can set fields.ownerId by name/email. Always resolve owner before creating an opportunity or assigning a person. Joel Pilger API GET /api/v1/crm/users.
crm_search_companies
ChatGPTSearch CRM companies Joel Pilger API GET /api/v1/crm/companies.
crm_search_leads
ChatGPTSearch CRM leads (may be unsupported by some providers → 400) Joel Pilger API GET /api/v1/crm/leads.
crm_search_opportunities
ChatGPTSearch CRM opportunities (deals) Joel Pilger API GET /api/v1/crm/opportunities.
crm_search_people
ChatGPTSearch CRM people (contacts) Joel Pilger API GET /api/v1/crm/people.
crm_update_record
ChatGPTUpdate allowed fields on a CRM record (additive; preview + confirm first) Canonical CrmWriteFields only. Opportunity: stageId, pipelineId, monetaryValue, status, closeDate, ownerId. Person: title, email, phone, companyId, linkedinUrl, details. Preview exact fields; one yes/no before calling. Joel Pilger API PATCH /api/v1/crm/records/{entityType}/{id}.
getCenterfile
ChatGPTGet full Centerfile (identity payload for Scout) Joel Pilger API GET /api/v1/me/centerfiles/{id}.
getLeadRoom
ChatGPTGet full lead room detail Joel Pilger API GET /api/v1/lead-rooms/{id}.
getPipelineEntry
ChatGPTGet one pipeline entry (lead) Joel Pilger API GET /api/v1/pipeline/{id}.
listAssignableOwners
ChatGPTList users who can own a pipeline entry (for resolving ownedByUserId) Always call this before POST /pipeline or before PATCHing ownedByUserId. Match on name/email and echo the chosen user to the human — never invent a userId. Joel Pilger API GET /api/v1/pipeline/assignable-users.
listCenterfiles
ChatGPTList Centerfiles for the user Joel Pilger API GET /api/v1/me/centerfiles.
listLeadRooms
ChatGPTList lead rooms for the user Joel Pilger API GET /api/v1/lead-rooms.
listMyGpts
ChatGPTList GPTs assigned to the user (metadata, URLs) Joel Pilger API GET /api/v1/me/gpts.
listPipeline
ChatGPTList pipeline entries (leads) for the authenticated user Joel Pilger API GET /api/v1/pipeline.
patchCenterfile
ChatGPTUpdate a Centerfile (rename and/or replace content) Called by the Centerfile Copilot GPT to push refinements. content is replace-all — read the current Centerfile first, merge edits client-side, then PATCH the full object. name is renamable on its own. Joel Pilger API PATCH /api/v1/me/centerfiles/{id}.
patchLeadRoom
ChatGPTRename / re-describe a lead room Joel Pilger API PATCH /api/v1/lead-rooms/{id}.
patchLeadRoomNotes
ChatGPTReplace lead-room notes (append client-side first if you want to keep history) Joel Pilger API PATCH /api/v1/lead-rooms/{id}/notes.
patchLeadRoomTask
ChatGPTUpdate a task (rename, complete/uncomplete, reorder) Joel Pilger API PATCH /api/v1/lead-rooms/{id}/tasks/{taskId}.
patchLinkedChat
ChatGPTUpdate a logged GPT chat entry Joel Pilger API PATCH /api/v1/lead-rooms/{id}/linked-chats/{chatId}.
patchPipelineEntry
ChatGPTUpdate a lead (structured write — exact enums) Joel Pilger API PATCH /api/v1/pipeline/{id}.
setDefaultCenterfile
ChatGPTMark a Centerfile as the user's default Joel Pilger API PATCH /api/v1/me/centerfiles/{id}/set-default.
whoAmI
ChatGPTVerify access — invoke on session start and sign-in requests Call first each session and when user asks to sign in or check access. HTTP 401 renders ChatGPT's Sign In button; prose without this call does not. Returns 200 only for ACTIVE provisioned users. Joel Pilger API GET /api/v1/integrations/whoami.