---
title: "Create Allowlist Item"
method: POST
path: "/allowlists"
tags: ["Allowlist"]
---

# Create Allowlist Item

`POST /allowlists`

Create an allowlist entry.

### Required API key scope
- Orders

## Request body

- object
  - `value` string, required — The allowed value. Returns made using this value will override any other return ineligibility.
  - `type` 'order' | 'email', required — The type of value allowed by this allowlist entry. `order` is the order number of the allowed order and `email` is the customer's email address.

## Response `200`

Success

- AllowlistEntryWithCreatedAtResponse
  - `id` integer — The unique identifier associated with the allowlist entry.
  - `type` 'order' | 'email' — The type of value allowed by this allowlist entry. `order` is the order number of the allowed order and `email` is the customer's email address.
  - `value` string — The allowed value. Returns made using this value will override any other return ineligibility.
  - `created_at` string, nullable — The date and time at which the entry was created.

## Other responses

- `401` — Unauthorized
- `422` — Unprocessable

---

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