> ## Documentation Index > Fetch the complete documentation index at: https://docs.lazyapp.in/llms.txt > Use this file to discover all available pages before exploring further. # Define an event type > Creates or replaces a workspace event type, so `POST /v1/events` accepts it and checks its `properties`. Idempotent by type, and brings an archived type back. Namespace your types (`clinic.appointment_booked`) so several products can share a workspace. **Required scope:** `templates:write` ## OpenAPI ````yaml /api-reference/openapi.json put /v1/event-definitions/{type} openapi: 3.1.0 info: title: LazyApp API version: v1 description: >- One WhatsApp API for developers, SaaS platforms and businesses. Every endpoint is Bearer-authenticated with a LazyApp API key, returns JSON, and is scoped to the workspace and mode (`live` or `test`) the key belongs to. Live keys need the Pro plan. A live key on a workspace below Pro gets `402` with `code: plan_limit_reached` on every request. Test keys work on every plan, so you can build against the test number before you upgrade. LazyApp adds 0% to Meta's message rates. Meta bills each message to the business's own Meta payment method; your LazyApp plan is billed separately. contact: name: LazyApp support url: https://lazyapp.in servers: - url: https://lazyapp.in description: Production security: - bearerAuth: [] tags: - name: Messages description: Send and schedule WhatsApp messages. - name: Contacts description: The people you message, and their identifiers. - name: Conversations description: Threads and their message history. - name: Calls description: WhatsApp call history for the workspace. - name: Templates description: Create, submit and sync message templates. - name: Media description: Upload, retrieve and delete media. - name: Broadcasts description: Template sends to many contacts at once. - name: Events description: Say what happened; LazyApp picks the template. - name: Flows description: WhatsApp Flows and their responses. - name: Webhooks description: Register endpoints and inspect deliveries. - name: Workflows description: Automations and their executions. - name: Verify description: One-time passcodes over WhatsApp. - name: Capabilities description: What each connected number supports. - name: Catalog description: Proxy Meta Commerce catalog products for a connection. - name: Platform description: Manage customers if you run a platform on LazyApp. - name: Meta-compatible proxy description: Drop-in endpoints for existing Cloud API integrations. - name: Connections description: >- Your WhatsApp numbers and the account behind them: health, limits, registration, display name, blue tick, QR codes, conversation starters, opt-in links, business profile and blocked users. - name: Billing description: >- Meta's message rates, which LazyApp passes on with 0% added, and the billing facts behind them. - name: Analytics description: Workspace messaging aggregates. - name: Groups description: WhatsApp group chats on a connection Meta has enabled. - name: Funding description: Local funding status and recorded WhatsApp charges. - name: Connections description: 'WhatsApp connections: block users, business profile, insights.' - name: Payments description: >- WhatsApp payments in India: ask for payment, follow it, update the order and refund. paths: /v1/event-definitions/{type}: put: tags: - Events summary: Define an event type description: >- Creates or replaces a workspace event type, so `POST /v1/events` accepts it and checks its `properties`. Idempotent by type, and brings an archived type back. Namespace your types (`clinic.appointment_booked`) so several products can share a workspace. **Required scope:** `templates:write` parameters: - name: type in: path required: true description: Lower-case words joined by dots, such as `real_estate.visit_booked`. schema: type: string maxLength: 64 pattern: ^[a-z0-9_]+(\.[a-z0-9_]+)+$ - name: Idempotency-Key in: header description: >- Optional. Makes this write safe to retry: the same key replays the first response instead of acting twice. schema: type: string maxLength: 255 requestBody: required: false content: application/json: schema: type: object properties: name: type: string maxLength: 255 description: type: string maxLength: 255 schema: $ref: '#/components/schemas/EventDefinitionSchema' responses: '200': description: Replaced. content: application/json: schema: $ref: '#/components/schemas/EventDefinition' '201': description: Created. content: application/json: schema: $ref: '#/components/schemas/EventDefinition' '401': description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: >- The key lacks the required scope, or is restricted from this phone number. content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: Validation failed. content: application/json: schema: $ref: '#/components/schemas/ValidationError' '429': description: Rate limit exceeded. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: EventDefinitionSchema: type: object nullable: true description: What `POST /v1/events` checks `properties` against. properties: required: type: array maxItems: 50 items: type: string maxLength: 64 properties: type: object additionalProperties: type: object properties: type: type: string enum: - string - number - integer - boolean - array - object enum: type: array items: type: string EventDefinition: type: object properties: type: type: string example: real_estate.visit_booked name: type: string nullable: true description: type: string nullable: true schema: $ref: '#/components/schemas/EventDefinitionSchema' archived: type: boolean archived_at: type: string format: date-time nullable: true created_at: type: string format: date-time nullable: true updated_at: type: string format: date-time nullable: true Error: type: object properties: message: type: string description: Human-readable description of what went wrong. code: type: string description: >- Stable machine-readable reason, when the failure is one a client can branch on. required: - message ValidationError: type: object properties: message: type: string errors: type: object additionalProperties: type: array items: type: string description: Field name to list of failures. required: - message securitySchemes: bearerAuth: type: http scheme: bearer description: Your API key, e.g. `sk_live_...` or `sk_test_...`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.