---
title: "Create Sieve Script (Alias Auth)"
method: POST
path: "/v1/sieve-scripts"
tags: ["Sieve Scripts"]
---

# Create Sieve Script (Alias Auth)

`POST /v1/sieve-scripts`

## Request

- Base URL: `https://api.forwardemail.net`
- URL: `https://api.forwardemail.net/v1/sieve-scripts`
- Auth: HTTP basic

Create a new Sieve script for the authenticated alias. Uses alias authentication instead of API token.

## Request body

- object
  - `name` string, required: Script name
  - `content` string, required: Sieve script content
  - `description` string: Script description

## Response `201`

Sieve script created

- SieveScript
  - `id` string, required: Unique script identifier
  - `name` string, required: Script name
  - `content` string, required: Sieve script content
  - `alias` string, required: Alias ID this script belongs to
  - `is_active` boolean: Whether the script is active
  - `priority` integer: Script priority (lower = higher priority)
  - `created_at` string, date-time: Creation timestamp
  - `updated_at` string, date-time: Last update timestamp
  - `object` string

## Other responses

- `400`: Error response
- `401`: Error response

---

[API](https://skmtc.dev/forwardemail/apis/forward-email-api.md) · [All operations](https://skmtc.dev/forwardemail/apis/forward-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forwardemail/apis/forward-email-api/revisions/ecefab4527f6?raw)