---
title: "Create Event Type"
method: POST
path: "/api/v1/event-type"
tags: ["Event Type"]
---

# Create Event Type

`POST /api/v1/event-type`

Create new or unarchive existing event type.

Unarchiving an event type will allow endpoints to filter on it and messages to be sent with it.
Endpoints filtering on the event type before archival will continue to filter on it.
This operation does not preserve the description and schemas.

## Headers

- `idempotency-key` string

## Request body

- EventTypeIn
  - `archived` boolean
  - `deprecated` boolean
  - `description` string, required
  - `featureFlags` string[], nullable
  - `groupName` string, nullable — The event type group's name
  - `name` string, required — The event type's name
  - `schemas` object, nullable — The schema for the event type for a specific version as a JSON schema.

## Response `201`

- EventTypeOut
  - `archived` boolean
  - `createdAt` string, date-time, required
  - `deprecated` boolean, required
  - `description` string, required
  - `featureFlag` string, nullable
  - `featureFlags` string[], nullable
  - `groupName` string, nullable — The event type group's name
  - `name` string, required — The event type's name
  - `schemas` object, nullable — The schema for the event type for a specific version as a JSON schema.
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Validation Error
- `429` — Too Many Requests

## Changes

- **2026-08-19** `dc130bd1b074` — 1 warning
  - removed the request property `featureFlag`

[Change history](https://skmtc.dev/svix/apis/svix-api/changes/api/v1/event-type/post.md)

---

[API](https://skmtc.dev/svix/apis/svix-api.md) · [All operations](https://skmtc.dev/svix/apis/svix-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/svix/svix-api/revisions/50dde67d2d2d/schema)