> For the complete documentation index, see [llms.txt](https://run.emailchaser.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://run.emailchaser.com/api-reference/copilot.md).

# Copilot

## Launch a draft outbound campaign and start lead finding

> Creates a DRAFT Emailchaser campaign (with its email sequence) scoped to the caller's workspace and kicks off Sales Navigator lead extraction. The campaign stays in DRAFT — nothing sends automatically.

```json
{"openapi":"3.1.1","info":{"title":"Emailchaser API","version":"1.0"},"servers":[{"url":"https://api.emailchaser.com/r"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"models.CopilotLaunchResponse":{"type":"object","properties":{"campaignId":{"type":"integer"},"jobId":{"type":"string"},"message":{"type":"string"},"status":{"type":"string"}}},"models.ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}},"models.ErrorUnauthorized":{"type":"object","properties":{"error":{"type":"string"}}},"models.CopilotLaunchRequest":{"type":"object","required":["name","salesNavSearchUrl","sequence"],"properties":{"icp":{"description":"ICP is optional and carried through for reference only.","allOf":[{"$ref":"#/components/schemas/models.CopilotICP"}]},"name":{"description":"Name is the campaign name.","type":"string"},"salesNavData":{"description":"SalesNavData is the optional base64 browser-extension payload that carries\nthe LinkedIn session required to actually run the search. When omitted the\nlead engine cannot authenticate to LinkedIn (see docs), so provide it to\nstart real extraction.","type":"string"},"salesNavSearchUrl":{"description":"SalesNavSearchURL is the LinkedIn Sales Navigator search URL the lead\nengine should extract leads from.","type":"string"},"sequence":{"description":"Sequence is the cold-email sequence to seed the draft campaign with.","type":"array","items":{"$ref":"#/components/schemas/models.CopilotSequenceStep"}}}},"models.CopilotICP":{"type":"object","properties":{"companySizes":{"type":"array","items":{"type":"string"}},"icpName":{"type":"string"},"industries":{"type":"array","items":{"type":"string"}},"personas":{"type":"array","items":{"$ref":"#/components/schemas/models.CopilotPersona"}},"seniorities":{"type":"array","items":{"type":"string"}},"suggestedSalesNavKeywords":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"},"titles":{"type":"array","items":{"type":"string"}}}},"models.CopilotPersona":{"type":"object","properties":{"seniority":{"type":"string"},"title":{"type":"string"}}},"models.CopilotSequenceStep":{"type":"object","required":["body","subject"],"properties":{"body":{"type":"string"},"followUpAfter":{"description":"FollowUpAfter is the number of days after the previous step. 0 for the\ninitial email; 1-30 for follow-ups.","type":"integer"},"subject":{"type":"string"}}}}},"paths":{"/copilot/launch":{"post":{"description":"Creates a DRAFT Emailchaser campaign (with its email sequence) scoped to the caller's workspace and kicks off Sales Navigator lead extraction. The campaign stays in DRAFT — nothing sends automatically.","tags":["Copilot"],"summary":"Launch a draft outbound campaign and start lead finding","responses":{"202":{"description":"Draft campaign created and lead finding started","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.CopilotLaunchResponse"}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.ErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.ErrorUnauthorized"}}}},"500":{"description":"Failed to create draft campaign","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.CopilotLaunchRequest"}}},"description":"Campaign name, Sales Nav search URL and sequence","required":true}}}}}
```

## Plan an outbound campaign from a website (read-only)

> Fetches the company website, infers an Ideal Customer Profile with the managed AI model, and drafts a suggested cold-email sequence. Creates nothing.

```json
{"openapi":"3.1.1","info":{"title":"Emailchaser API","version":"1.0"},"servers":[{"url":"https://api.emailchaser.com/r"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"models.CopilotPlanResponse":{"type":"object","properties":{"icp":{"$ref":"#/components/schemas/models.CopilotICP"},"suggestedSequence":{"type":"array","items":{"$ref":"#/components/schemas/models.CopilotSequenceStep"}}}},"models.CopilotICP":{"type":"object","properties":{"companySizes":{"type":"array","items":{"type":"string"}},"icpName":{"type":"string"},"industries":{"type":"array","items":{"type":"string"}},"personas":{"type":"array","items":{"$ref":"#/components/schemas/models.CopilotPersona"}},"seniorities":{"type":"array","items":{"type":"string"}},"suggestedSalesNavKeywords":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"},"titles":{"type":"array","items":{"type":"string"}}}},"models.CopilotPersona":{"type":"object","properties":{"seniority":{"type":"string"},"title":{"type":"string"}}},"models.CopilotSequenceStep":{"type":"object","required":["body","subject"],"properties":{"body":{"type":"string"},"followUpAfter":{"description":"FollowUpAfter is the number of days after the previous step. 0 for the\ninitial email; 1-30 for follow-ups.","type":"integer"},"subject":{"type":"string"}}},"models.ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}},"models.ErrorUnauthorized":{"type":"object","properties":{"error":{"type":"string"}}},"models.CopilotPlanRequest":{"type":"object","required":["website"],"properties":{"context":{"description":"Context is optional extra guidance from the caller (e.g. \"we sell to\ndentists in the US\").","type":"string"},"website":{"description":"Website is the company homepage to analyse (with or without scheme).","type":"string"}}}}},"paths":{"/copilot/plan":{"post":{"description":"Fetches the company website, infers an Ideal Customer Profile with the managed AI model, and drafts a suggested cold-email sequence. Creates nothing.","tags":["Copilot"],"summary":"Plan an outbound campaign from a website (read-only)","responses":{"200":{"description":"Suggested ICP and sequence","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.CopilotPlanResponse"}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.ErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.ErrorUnauthorized"}}}},"502":{"description":"Failed to analyse website","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.ErrorResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.CopilotPlanRequest"}}},"description":"Website to analyse","required":true}}}}}
```