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.