/v2/campaigns/lead-finder/save-companiesSaves company search results to your account. No provider call involved — a company result already comes back complete, so this is a plain write, but it still spends 1 credit per company (this save IS the "export" step). Calling this again for an already-saved company adds the new list alongside any it's already in — a company can belong to multiple lists at once.
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
| Field | Type | Required | Description |
|---|---|---|---|
| companies | object[] | Required | 1–20,000 full company objects, exactly as returned by Search companies. |
| label | object | Optional | { name, color } — which list to add these to. Omitted just saves/updates the company without changing its lists. |
curl -X POST "https://api.stynar.com/v2/campaigns/lead-finder/save-companies" \
-H "Authorization: Bearer esk_your_key_here" \
-H "Content-Type: application/json" \
-d '{"companies":[{"companyId":"cmp_prs_9f8e7d","name":"Acme Inc","domain":"acme.com","website":"https://acme.com","logoUrl":null,"industry":"Software","employeeCount":120,"employeeRange":"51-200","location":"Austin, United States","linkedinUrl":"https://linkedin.com/company/acme","founded":2015,"revenuePrinted":"10M-50M","type":"Private"}]}'{
"saved": 1
}| Status | Code | Meaning |
|---|---|---|
| ✕ 402 | INSUFFICIENT_CREDITS | Not enough credits (1 per company). |
| ✕ 401 Unauthorized | UNAUTHORIZED | Missing, malformed, unknown, revoked, or expired key. |
| ✕ 403 Forbidden | API_ACCESS_DISABLED | API access is turned off for your account. |
| ✕ 403 Forbidden | INSUFFICIENT_SCOPE | The key doesn't have the scope this endpoint requires. |
| ✕ 404 Not Found | NOT_FOUND | Unknown route, or a resource that doesn't exist / isn't yours. |
| ✕ 409 Conflict | CONFLICT | The action can't be applied to the resource's current state. |
| ✕ 429 Too Many Requests | RATE_LIMIT_EXCEEDED | Per-minute or per-second limit hit. |
| ✕ 429 Too Many Requests | QUOTA_EXCEEDED | Monthly quota exhausted. |
| ✕ 500 Internal Server Error | INTERNAL_ERROR | Something broke on Stynar's end. |