---
title: "Resolve the caller's contact by LinkedIn URL"
method: POST
path: "/business/contacts/resolve"
tags: ["Contacts"]
---

# Resolve the caller's contact by LinkedIn URL

`POST /business/contacts/resolve`

## Request

- Base URL: `https://api.tryfuse.ai/api/v1`
- URL: `https://api.tryfuse.ai/api/v1/business/contacts/resolve`
- Auth: HTTP basic

Looks up the contact record for a LinkedIn profile URL and returns its `contactId`, the id every other contacts endpoint and every list row uses. The URL is normalised before matching, so `https://www.linkedin.com/in/ada-nwosu/` and `linkedin.com/in/ada-nwosu` resolve the same contact; a value that carries no `linkedin.com/` path is rejected with 422. Contacts are canonical records: a match is returned whether the person reached your workspace through search, an upload or an enrichment, while contacts your team created by hand are matched within your team only. Answers 404 CONTACT_NOT_FOUND when no contact exists for that URL; create it by adding the person to a list (`POST /business/lists/{listId}/contacts`) and resolve again. Read-only and free: it never creates or changes a contact.

Errors:
- `404` `CONTACT_NOT_FOUND` — No contact exists for that LinkedIn URL.
- `422` `INVALID_REQUEST` — The URL could not be read as a LinkedIn profile.
- `422` `VALIDATION_FAILED` — The body failed validation — a missing linkedinUrl, one over 500 characters, or one that is not a linkedin.com profile URL.
- `429` `RATE_LIMITED` — More than 120 requests per minute or 10,000 per day on the contacts bucket, which every /business/contacts endpoint shares; retry after Retry-After.
- `500` `UNEXPECTED_ERROR` — The request could not be completed; quote request_id to support.

Requires one of the following token scopes: contacts.

## Request body

- object
  - `linkedinUrl` string, required: The contact's LinkedIn profile URL (max 500 characters). Any form is accepted as long as it contains linkedin.com/in/...: the protocol, www prefix and trailing slash are ignored when matching.

## Response `200`

Success

- object
  - `contactId` string, required: Id of the contact for that LinkedIn URL.

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `429`: Error
- `500`: Error

---

[API](https://skmtc.dev/fuseai/apis/fuse-business-api.md) · [All operations](https://skmtc.dev/fuseai/apis/fuse-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fuseai/apis/fuse-business-api/revisions/50d95e0536f4?raw)