> ## Documentation Index > Fetch the complete documentation index at: https://docs.fuseai.com/llms.txt > Use this file to discover all available pages before exploring further. # Resolve the caller's contact by LinkedIn URL > 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. ## OpenAPI ````yaml /openapi.json post /business/contacts/resolve openapi: 3.1.0 info: title: Fuse Business API version: 1.0.0 description: >- External API for lists, campaigns, prospect search and contacts. Authenticate with your API token as HTTP Basic. All paths are under /api/v1. servers: - url: https://api.tryfuse.ai/api/v1 description: Production security: - basicAuth: [] tags: - name: Lists - name: Custom columns - name: Smart columns - name: Exports - name: Campaigns - name: Knowledge hubs - name: Analytics - name: Website intent - name: Account - name: Prospect search - name: Campaign steps - name: Scheduled sends - name: Campaign templates - name: Agents - name: Research - name: Company search - name: Saved searches - name: Folders - name: Contacts paths: /business/contacts/resolve: post: tags: - Contacts summary: Resolve the caller's contact by LinkedIn URL description: >- 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. operationId: resolveContactByLinkedinUrl requestBody: required: true content: application/json: schema: type: object properties: linkedinUrl: type: string maxLength: 500 description: >- 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. required: - linkedinUrl responses: '200': description: Success headers: RateLimit-Limit: schema: type: integer description: Requests permitted in the current window. RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. RateLimit-Reset: schema: type: integer description: Seconds until the current window resets. content: application/json: schema: type: object required: - contactId properties: contactId: type: string description: Id of the contact for that LinkedIn URL. example: contactId: 68a1f2c89c41d20014b3e955 '400': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' security: - basicAuth: [] components: schemas: Error: type: object properties: error: type: object properties: code: type: string message: type: string param: type: - string - 'null' doc_url: type: - string - 'null' request_id: type: - string - 'null' required: - code - message required: - error securitySchemes: basicAuth: type: http scheme: basic description: >- Your API token (`af_…`) as the Basic-auth username, with an empty password. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.