> ## Documentation Index > Fetch the complete documentation index at: https://docs.operate.so/llms.txt > Use this file to discover all available pages before exploring further. # Create a person > Creates a new person/contact with the provided details. Email addresses, titles, and location are automatically processed. ## OpenAPI ````yaml openapi.json post /v/alpha/people/create openapi: 3.1.0 info: title: Operate API Documentation description: 'API for Operate: A CRM designed for sales, built for founders' version: Alpha servers: - url: https://api.operate.so security: - apiKey: [] tags: - name: Companies description: Manage companies and their associated data - name: People description: Manage people/contacts and their associated data - name: Deals description: Manage deals and opportunities - name: Feedback description: Manage customer feedback and feature requests - name: Next Steps description: Manage action items and next steps - name: Profiles description: Manage organization profiles (team members) paths: /v/alpha/people/create: post: tags: - People summary: Create a person description: >- Creates a new person/contact with the provided details. Email addresses, titles, and location are automatically processed. operationId: postVAlphaPeopleCreate requestBody: required: true content: application/json: schema: type: object properties: email: description: Email address(es) for the person anyOf: - format: email description: Primary email address examples: - john.doe@example.com type: string - description: Multiple email addresses type: array items: format: email type: string full_name: minLength: 1 description: Full name of the person examples: - John Doe - Jane Smith type: string cue: maxLength: 280 description: >- A brief note or reminder about the person (max 280 characters) examples: - Follow up about project proposal - Met at conference last week type: string timezone: description: >- IANA timezone name, alternative name, or abbreviation. Examples: 'America/New_York', 'Eastern Time', 'EST', 'UTC'. See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for full list. examples: - America/New_York - Eastern Time - EST - UTC - Pacific Time - PST type: string titles: description: Job titles and roles for this person examples: - - title: Software Engineer company_id: 123e4567-e89b-12d3-a456-426614174000 order_index: 0 type: array items: type: object properties: title: minLength: 1 description: Job title or role examples: - Software Engineer - CEO - Product Manager type: string company_id: format: uuid description: ID of the company where this title applies (optional) type: string order_index: minimum: 0 maximum: 1000 description: Order of this title (0-based, lower numbers first) examples: - 0 - 1 - 2 type: number required: - title location: description: >- Location display string (e.g., 'Seattle, WA', 'New York, NY') examples: - Seattle, WA - New York, NY - San Francisco, CA type: string required: - email - full_name application/x-www-form-urlencoded: schema: type: object properties: email: description: Email address(es) for the person anyOf: - format: email description: Primary email address examples: - john.doe@example.com type: string - description: Multiple email addresses type: array items: format: email type: string full_name: minLength: 1 description: Full name of the person examples: - John Doe - Jane Smith type: string cue: maxLength: 280 description: >- A brief note or reminder about the person (max 280 characters) examples: - Follow up about project proposal - Met at conference last week type: string timezone: description: >- IANA timezone name, alternative name, or abbreviation. Examples: 'America/New_York', 'Eastern Time', 'EST', 'UTC'. See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for full list. examples: - America/New_York - Eastern Time - EST - UTC - Pacific Time - PST type: string titles: description: Job titles and roles for this person examples: - - title: Software Engineer company_id: 123e4567-e89b-12d3-a456-426614174000 order_index: 0 type: array items: type: object properties: title: minLength: 1 description: Job title or role examples: - Software Engineer - CEO - Product Manager type: string company_id: format: uuid description: ID of the company where this title applies (optional) type: string order_index: minimum: 0 maximum: 1000 description: Order of this title (0-based, lower numbers first) examples: - 0 - 1 - 2 type: number required: - title location: description: >- Location display string (e.g., 'Seattle, WA', 'New York, NY') examples: - Seattle, WA - New York, NY - San Francisco, CA type: string required: - email - full_name multipart/form-data: schema: type: object properties: email: description: Email address(es) for the person anyOf: - format: email description: Primary email address examples: - john.doe@example.com type: string - description: Multiple email addresses type: array items: format: email type: string full_name: minLength: 1 description: Full name of the person examples: - John Doe - Jane Smith type: string cue: maxLength: 280 description: >- A brief note or reminder about the person (max 280 characters) examples: - Follow up about project proposal - Met at conference last week type: string timezone: description: >- IANA timezone name, alternative name, or abbreviation. Examples: 'America/New_York', 'Eastern Time', 'EST', 'UTC'. See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for full list. examples: - America/New_York - Eastern Time - EST - UTC - Pacific Time - PST type: string titles: description: Job titles and roles for this person examples: - - title: Software Engineer company_id: 123e4567-e89b-12d3-a456-426614174000 order_index: 0 type: array items: type: object properties: title: minLength: 1 description: Job title or role examples: - Software Engineer - CEO - Product Manager type: string company_id: format: uuid description: ID of the company where this title applies (optional) type: string order_index: minimum: 0 maximum: 1000 description: Order of this title (0-based, lower numbers first) examples: - 0 - 1 - 2 type: number required: - title location: description: >- Location display string (e.g., 'Seattle, WA', 'New York, NY') examples: - Seattle, WA - New York, NY - San Francisco, CA type: string required: - email - full_name responses: '200': description: Successful response components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: API key for authentication. Obtain from your Operate dashboard. ````