> ## Documentation Index > Fetch the complete documentation index at: https://docs.lukittu.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Customer > Create a new customer record for the specified team. Customers can be associated with licenses for tracking and management. ## OpenAPI ````yaml /api-reference/openapi.json post /api/v1/dev/teams/{teamId}/customers openapi: 3.0.1 info: title: Lukittu API description: > The Lukittu API provides comprehensive license management and verification services for software products. ## Authentication **Client Endpoints** (`/api/v1/client/*`): No authentication required. These are public endpoints for license verification. **Developer Endpoints** (`/api/v1/dev/*`): Require API key authentication via Bearer token. ## API Types - **Client API**: Used by your software to verify licenses, send heartbeats, and download releases - **Developer API**: Used for programmatic license management from your backend systems ## Rate Limiting All endpoints are rate-limited to prevent abuse. If you exceed the rate limit, you'll receive a 429 status code. ## Response Format All responses follow a consistent format with `data` and `result` objects: ```json { "data": {}, // Response data (null for errors) "result": { "timestamp": "2023-09-15T14:30:00Z", "valid": true, "details": "Human-readable message", "code": "SUCCESS_CODE" // Optional error/success code } } ``` version: 1.0.0 contact: name: Lukittu Community url: https://discord.lukittu.com servers: - url: https://app.lukittu.com description: Production server security: [] tags: - name: Client - Verify description: > Client endpoints for license verification, heartbeat monitoring, and file downloads. These endpoints are used directly by your software applications. - name: Dev - Licenses description: | Developer endpoints for license management operations. These endpoints require API key authentication. - name: Dev - Customers description: | Developer endpoints for customer management operations. These endpoints require API key authentication. - name: Dev - Releases description: | Developer endpoints for release management operations. These endpoints require API key authentication. - name: Dev - Statistics description: | Developer endpoints for retrieving team usage statistics. These endpoints require API key authentication. paths: /api/v1/dev/teams/{teamId}/customers: post: tags: - Dev - Customers summary: Create Customer description: | Create a new customer record for the specified team. Customers can be associated with licenses for tracking and management. operationId: createCustomer parameters: - $ref: '#/components/parameters/TeamId' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CustomerRequest' responses: '201': description: Customer created successfully content: application/json: schema: $ref: '#/components/schemas/CustomerResponse' example: data: id: 789e0123-e89b-12d3-a456-426614174222 email: customer@example.com fullName: John Doe username: johndoe metadata: - key: tier value: standard locked: false address: street: 123 Main St city: Anytown state: CA country: US postalCode: '12345' discordAccount: null teamId: 123e4567-e89b-12d3-a456-426614174000 createdByUserId: 456e7890-e89b-12d3-a456-426614174111 createdAt: '2023-09-15T14:30:00Z' updatedAt: '2023-09-15T14:30:00Z' result: timestamp: '2023-09-15T14:30:00Z' valid: true details: Customer created 4XX: $ref: '#/components/responses/StandardError' 5XX: $ref: '#/components/responses/StandardError' security: - bearerAuth: [] components: parameters: TeamId: name: teamId in: path required: true description: >- Your team's UUID. You can find this value in your team's settings on the Lukittu dashboard. schema: $ref: '#/components/schemas/UUID' example: 123e4567-e89b-12d3-a456-426614174000 schemas: CustomerRequest: type: object properties: email: type: string format: email nullable: true fullName: type: string nullable: true username: type: string nullable: true discordId: type: string pattern: ^\d{17,19}$ nullable: true description: >- Discord user ID (snowflake). When provided, Discord user will be validated and associated with this customer. metadata: $ref: '#/components/schemas/Metadata' address: $ref: '#/components/schemas/Address' nullable: true CustomerResponse: allOf: - $ref: '#/components/schemas/SuccessResponse' - type: object properties: data: $ref: '#/components/schemas/CustomerData' UUID: type: string format: uuid description: UUID v4 identifier Metadata: type: array description: Key-value metadata pairs items: type: object properties: key: type: string description: Metadata key value: type: string description: Metadata value locked: type: boolean description: Whether this metadata field is locked from client modification required: - key - value - locked Address: type: object properties: street: type: string nullable: true description: Street address city: type: string nullable: true description: City state: type: string nullable: true description: State or province country: type: string nullable: true description: Country postalCode: type: string nullable: true description: Postal or ZIP code SuccessResponse: type: object properties: data: type: object description: Response data result: allOf: - $ref: '#/components/schemas/StandardResult' - type: object properties: valid: type: boolean enum: - true description: Always true for success responses required: - data - result CustomerData: type: object properties: id: $ref: '#/components/schemas/UUID' description: Unique customer identifier email: type: string format: email nullable: true description: Customer email address fullName: type: string nullable: true description: Customer full name username: type: string nullable: true description: Customer username metadata: $ref: '#/components/schemas/Metadata' address: $ref: '#/components/schemas/Address' nullable: true description: Customer address information discordAccount: $ref: '#/components/schemas/DiscordAccount' nullable: true description: Associated Discord account information teamId: $ref: '#/components/schemas/UUID' description: Team that owns this customer createdByUserId: $ref: '#/components/schemas/UUID' description: User who created this customer record createdAt: type: string format: date-time description: Customer record creation timestamp updatedAt: type: string format: date-time description: Customer record last update timestamp required: - id - teamId - createdByUserId - createdAt - updatedAt ErrorResponse: type: object properties: data: type: object description: Additional error-related data nullable: true result: allOf: - $ref: '#/components/schemas/StandardResult' - type: object properties: valid: type: boolean enum: - false description: Always false for error responses code: type: string description: Error code indicating the specific issue enum: - INTERNAL_SERVER_ERROR - BAD_REQUEST - LICENSE_NOT_FOUND - IP_LIMIT_REACHED - HWID_LIMIT_REACHED - PRODUCT_NOT_FOUND - CUSTOMER_NOT_FOUND - LICENSE_EXPIRED - LICENSE_SUSPENDED - TEAM_NOT_FOUND - RATE_LIMIT - HARDWARE_IDENTIFIER_BLACKLISTED - COUNTRY_BLACKLISTED - IP_BLACKLISTED - RELEASE_NOT_FOUND - FORBIDDEN - UNAUTHORIZED - INVALID_SESSION_KEY - NO_ACCESS_TO_RELEASE - RELEASE_ARCHIVED - RELEASE_DRAFT required: - code required: - result StandardResult: type: object properties: timestamp: type: string format: date-time description: Timestamp when the response was generated valid: type: boolean description: Indicates whether the operation was successful details: type: string description: Human-readable description of the result required: - timestamp - valid - details DiscordAccount: type: object properties: id: $ref: '#/components/schemas/UUID' description: Discord account record ID customerId: $ref: '#/components/schemas/UUID' description: Associated customer ID discordId: type: string pattern: ^\d{17,19}$ description: Discord user ID (snowflake) username: type: string description: Discord username avatar: type: string nullable: true description: Discord avatar hash (null if no custom avatar) createdAt: type: string format: date-time description: Discord account record creation timestamp updatedAt: type: string format: date-time description: Discord account record last update timestamp required: - id - customerId - discordId - username - createdAt - updatedAt responses: StandardError: description: > Standard API error response. All errors follow the same `{data, result}` structure. The HTTP status code indicates the general error category, while `result.code` provides specific error details. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: apiKey description: > API key authentication for development endpoints. You can create API keys in your team's settings on the Lukittu dashboard. Include the API key in the Authorization header as: `Bearer YOUR_API_KEY` Example: ``` Authorization: Bearer lukittu_api_key_abc123def456... ``` ````