---
title: "Save a company or job to your leads, optionally into a lead list by name."
method: POST
path: "/v1/leads"
tags: ["Your leads"]
---

# Save a company or job to your leads, optionally into a lead list by name.

`POST /v1/leads`

## Request

- Base URL: `https://linkfetch.io`
- URL: `https://linkfetch.io/v1/leads`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Save a company or job to your leads, optionally into a lead list by name.

Free.

MCP tool: `save_lead`.

## Request body

- object
  - `type` 'company' | 'job', required
  - `id` union, required: The company or job id.
    - integer
    - string
  - `list` string: Lead list name; created if it doesn't exist.

## Response `200`

OK

- object
  - `saved` boolean
  - `type` string
  - `id` integer
  - `list` string, nullable

## Other responses

- `400`: Invalid input (`bad_request`).
- `401`: Missing, invalid or revoked API key (`unauthorized`).
- `default`: Other errors: 409 account session needs attention, 428 no connected account (`no_account`), 501 not in the API yet (`coming_soon`), 502 LinkedIn failed (`upstream`), 503 `unavailable`, 500 `internal`.

---

[API](https://skmtc.dev/linkfetch/apis/linkfetch-api.md) · [All operations](https://skmtc.dev/linkfetch/apis/linkfetch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/linkfetch/apis/linkfetch-api/revisions/b83d21f70fcb?raw)