> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enrich Profile

> Enrich a person profile from LinkedIn URL, email, or name

## Overview

Enrich a person's profile with detailed information including job title, company, social profiles, and more. Supports lookup by LinkedIn URL, email address, or name + company.

## Request Body

At least one identifier is required:

<ParamField body="linkedin_url" type="string">
  LinkedIn profile URL (e.g., "linkedin.com/in/satyanadella")
</ParamField>

<ParamField body="email" type="string">
  Email address to look up
</ParamField>

<ParamField body="name" type="string">
  Full name (works best with company\_domain)
</ParamField>

<ParamField body="company_domain" type="string">
  Company domain to help disambiguate (e.g., "microsoft.com")
</ParamField>

<Snippet file="audit-context-params.mdx" />

## Response (202 - Processing)

```json theme={null}
{
  "request_id": "req_abc123",
  "status": "processing",
  "tool": "enrich_profile",
  "message": "Profile enrichment job queued successfully"
}
```

## Job Result

```json theme={null}
{
  "status": "completed",
  "result": {
    "profile": {
      "full_name": "Satya Nadella",
      "first_name": "Satya",
      "last_name": "Nadella",
      "title": "Chairman and CEO",
      "company": "Microsoft",
      "company_domain": "microsoft.com",
      "linkedin_url": "linkedin.com/in/satyanadella",
      "location": "Bellevue, Washington",
      "email": "satya@microsoft.com",
      "phone": "+14255551234",
      "summary": "Chairman and CEO of Microsoft...",
      "skills": ["Leadership", "Cloud Computing", "AI"],
      "experience": [
        {
          "company": { "name": "Microsoft" },
          "title": { "name": "Chairman and CEO" },
          "start_date": "2014-02",
          "is_primary": true
        }
      ],
      "education": [
        {
          "school": { "name": "University of Wisconsin-Milwaukee" },
          "degrees": ["Master of Science"],
          "majors": ["Computer Science"]
        }
      ]
    }
  }
}
```

## SDK Usage

```typescript theme={null}
// By LinkedIn URL
const profile = await agent.enrichProfile({
  linkedin_url: 'linkedin.com/in/satyanadella'
});

// By email
const profile = await agent.enrichProfile({
  email: 'satya@microsoft.com'
});

// By name + company
const profile = await agent.enrichProfile({
  name: 'Satya Nadella',
  company_domain: 'microsoft.com'
});

console.log(`${profile.profile.full_name}`);
console.log(`${profile.profile.title} at ${profile.profile.company}`);
```

## Data Fields

| Field            | Description            |
| ---------------- | ---------------------- |
| `full_name`      | Full name              |
| `first_name`     | First name             |
| `last_name`      | Last name              |
| `title`          | Current job title      |
| `company`        | Current company name   |
| `company_domain` | Company website domain |
| `linkedin_url`   | LinkedIn profile URL   |
| `location`       | Location (city, state) |
| `email`          | Email address          |
| `phone`          | Phone number           |
| `summary`        | Bio / summary          |
| `skills`         | Array of skills        |
| `experience`     | Work history           |
| `education`      | Education history      |