---
title: "Email to LinkedIn"
method: POST
path: "/email_to_linkedin"
tags: ["Get LinkedIn"]
---

# Email to LinkedIn

`POST /email_to_linkedin`

## Request

- Base URL: `https://api.moltsets.com/api/v1/tools`
- URL: `https://api.moltsets.com/api/v1/tools/email_to_linkedin`
- Auth: HTTP bearer

The Email to LinkedIn API resolves an email address to the highest-confidence LinkedIn profile URL when multiple candidates exist.

It scores all matching profiles and returns the single best full LinkedIn URL. Use this when match quality matters, for example before personalising outreach, triggering enrichment workflows, or appending LinkedIn data to a contact record.

**Use this endpoint to:**
- Attach the correct LinkedIn profile to an email-only contact
- Personalise outreach with accurate LinkedIn context
- Trigger downstream enrichment workflows from an email address

**Fair Use Policy:**
This API is subject to our <a href="https://moltsets.com/fair-use-policy-enrichment/" target="_blank" rel="noopener">Fair Use Policy for Enrichment</a>.

**Outcomes:**
A lookup that finds nothing is not an error. It returns HTTP `200` with `status: "not_found"`, empty or null `results`, and the usual `metadata` — and costs no tokens, though it still counts as one request against your Fair Use requests limit. Read `status`, not the HTTP code, to tell a hit from a miss. The API's only `404` is an unknown or retired tool name.

## Headers

- `User-Agent` string, required

## Request body

- object
  - `email` string: Email address.

## Response `200`

Success

## Other responses

- `401`: Unauthorized
- `402`: Payment Required — insufficient tokens
- `403`: Forbidden — missing `User-Agent` header, tool not on the plan, or account inactive
- `422`: Invalid Input — malformed body, or a parameter is missing, malformed, or outside its allowed values
- `429`: Too Many Requests — rate limit or Fair Use window exhausted
- `500`: Internal Server Error — the call could not complete. Usually the endpoint is temporarily unavailable, but an oversized request can also cause it. Retry with a smaller request first; the MoltSets team is alerted automatically.

---

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