# Create Guest Profile

> Pod Engine API endpoint reference, optimized for LLM consumption.
> Auto-generated from the source-of-truth endpoint registry.
>
> Category: Guest Profiles
> Source: https://www.podengine.ai/api-docs/create-guest-profile.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/create-guest-profile
> Full API reference (all endpoints): https://www.podengine.ai/api-docs/llms.txt

**Base URL:** `http://localhost:4000`
**Auth:** Requires a Bearer token: `Authorization: Bearer YOUR_API_KEY`

---

#### POST /api/v1/guest-profiles
**Create Guest Profile**

Create a new guest profile with basic information. The profile is created in ACTIVE status along with an associated project. Required fields are firstName, lastName, and shortBio. Optional fields include contact details, social links, and bio details. When provided, LinkedIn URLs trigger a profile scrape, website URLs trigger a website crawl, and company names trigger a SERP search — all run asynchronously in the background. A guest appearances search is also triggered automatically.

```bash
curl -X POST "http://localhost:4000/api/v1/guest-profiles" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "firstName": "Jane",
  "lastName": "Doe",
  "shortBio": "Jane Doe is a marketing expert with 10 years of experience in B2B SaaS."
}'
```

**Request body schema:**
```json
{
  "type": "object",
  "properties": {
    "firstName": {
      "type": "string",
      "minLength": 1,
      "description": "First name of the guest"
    },
    "lastName": {
      "type": "string",
      "minLength": 1,
      "description": "Last name of the guest"
    },
    "shortBio": {
      "type": "string",
      "minLength": 1,
      "description": "A short bio for the guest"
    },
    "longBio": {
      "description": "A longer bio for the guest",
      "type": "string"
    },
    "email": {
      "description": "Email address",
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "phone": {
      "description": "Phone number",
      "type": "string"
    },
    "companyName": {
      "description": "Company name",
      "type": "string"
    },
    "websiteUrl": {
      "description": "Website URL",
      "type": "string",
      "format": "uri"
    },
    "bookingUrl": {
      "description": "Calendar booking URL",
      "type": "string",
      "format": "uri"
    },
    "linkedIn": {
      "description": "LinkedIn profile URL",
      "type": "string",
      "format": "uri"
    },
    "onePagerUrl": {
      "description": "One-pager document URL",
      "type": "string",
      "format": "uri"
    },
    "topicsToDiscuss": {
      "description": "Topics the guest wants to discuss",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "areasOfExpertise": {
      "description": "Areas of expertise",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "goals": {
      "description": "Goals for podcast appearances",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "thingsToAvoid": {
      "description": "Topics or things to avoid",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "additionalContext": {
      "description": "Any additional context about the guest",
      "type": "string"
    },
    "createAlert": {
      "description": "Optionally create a person alert for this guest, defaults to true",
      "type": "boolean"
    }
  },
  "required": [
    "firstName",
    "lastName",
    "shortBio"
  ],
  "additionalProperties": false
}
```

**Response schema:**
```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "guestProfileId": {
          "type": "string"
        },
        "guestProfileSlug": {
          "type": "string"
        },
        "projectId": {
          "type": "string"
        },
        "projectSlug": {
          "type": "string"
        }
      },
      "required": [
        "guestProfileId",
        "guestProfileSlug",
        "projectId",
        "projectSlug"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "status",
    "data"
  ],
  "additionalProperties": false
}
```

---

## See also

- All endpoints in one file: https://www.podengine.ai/api-docs/llms.txt
- Full reference with every schema inlined: https://www.podengine.ai/api-docs/llms-full.txt
- OpenAPI 3.1 spec: https://www.podengine.ai/api-docs/openapi.json
- Get an API key: https://www.podengine.ai/get-started
- Support: support@podengine.ai