> ## Documentation Index > Fetch the complete documentation index at: https://docs.mapp.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a coupon list > Creates an empty list owned by the authenticated caller. Name must contain 3-50 alphanumeric characters. Optional previewText accepts up to 200 characters; optional defaultText accepts up to 500 characters. Does not accept coupon codes. Reminders are disabled by default. Supply a non-negative remindThreshold to enable them; zero means remind when empty. additionalReminderEmail is an optional recipient (maximum 200 characters). ## OpenAPI ````json POST /couponList/create { "openapi": "3.0.4", "info": { "title": "Engage public API", "version": "1" }, "servers": [ { "url": "https://your-engage-domain.com/api/rest" } ], "tags": [ { "name": "Address Attributes" }, { "name": "Async" }, { "name": "Audit Log" }, { "name": "Automation" }, { "name": "Blacklist" }, { "name": "CMS (legacy)" }, { "name": "CMS Blocks" }, { "name": "CMS Frameworks" }, { "name": "CMS Messages" }, { "name": "CMS Templates" }, { "name": "Contact" }, { "name": "Content" }, { "name": "Coupon" }, { "name": "Draft Message" }, { "name": "Ecommerce" }, { "name": "Group" }, { "name": "Group Attributes" }, { "name": "Landing Page" }, { "name": "Member Attributes" }, { "name": "Membership" }, { "name": "Message" }, { "name": "Meta" }, { "name": "Mobile Push" }, { "name": "Prepared Message" }, { "name": "Process" }, { "name": "Profile Attributes" }, { "name": "Related Data" }, { "name": "Segmentation" }, { "name": "System" }, { "name": "System User" }, { "name": "Usage Statistics" }, { "name": "User" }, { "name": "Whiteboard" } ], "paths": { "/couponList/create": { "post": { "tags": [ "Coupon" ], "summary": "Create a coupon list", "description": "Creates an empty list owned by the authenticated caller. Name must contain 3-50 alphanumeric characters. Optional previewText accepts up to 200 characters; optional defaultText accepts up to 500 characters. Does not accept coupon codes. Reminders are disabled by default. Supply a non-negative remindThreshold to enable them; zero means remind when empty. additionalReminderEmail is an optional recipient (maximum 200 characters).", "operationId": "create", "requestBody": { "description": "Settings for a new coupon list. Name is required.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CouponListCreateSettings" } } }, "required": true, "x-bodyName": "body" }, "responses": { "200": { "description": "Identifier of the newly created empty coupon list.", "content": { "application/json": { "schema": { "type": "integer", "format": "int64" } } } }, "400": { "description": "InvalidParameterException / MISSING_PARAMETER: settings is missing; INVALID_PARAMETER: name must contain 3-50 alphanumeric characters, description or defaultText exceeds 500 characters, or previewText exceeds 200 characters; reminder settings are inconsistent, the threshold is negative, or the additional recipient is invalid or exceeds 200 characters.
ObjectAlreadyExistsException / OBJECT_ALREADY_EXISTS: name is already used in this customer, including archived lists; names are stored in lowercase.
UnexpectedErrorException / PERMISSION_DENIED: caller lacks permission to create a coupon list.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceExceptionBean" } } } }, "500": { "description": "UnexpectedErrorException / UNEXPECTED_ERROR: a backend operation failed; errorActor is SERVER.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceExceptionBean" } } } } } } } }, "components": { "schemas": { "CouponListCreateSettings": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "List name: 3-50 alphanumeric characters, stored in lowercase. Required when creating a list." }, "description": { "type": "string", "description": "Optional description, up to 500 characters." }, "previewText": { "type": "string", "description": "Placeholder used instead of a real coupon code in message previews; up to 200 characters. Unset or empty uses the list name followed by _previewCoupon." }, "defaultText": { "type": "string", "description": "Fallback text used when no coupon code is available during sendout; up to 500 characters. Optional; no fallback is configured when omitted." }, "reminderEnabled": { "type": "boolean", "description": "False disables reminders and clears the threshold and additional recipient. True requires a supplied or existing threshold. Omitted or null preserves settings on update.", "default": false }, "remindThreshold": { "type": "integer", "description": "Non-negative available-code count at or below which the owner is reminded. Zero means remind when empty. Supplying it enables reminders; conflicts with reminderEnabled=false. Omitted or null preserves the threshold on update.", "format": "int64" }, "additionalReminderEmail": { "type": "string", "description": "Optional additional recipient: valid email, up to 200 characters. Requires enabled reminders. Empty clears it; omitted or null preserves it on update." } } }, "ServiceExceptionBean": { "type": "object", "properties": { "errorActor": { "type": "string" }, "errorCode": { "type": "string" }, "message": { "type": "string" } }, "xml": { "name": "ServiceException" } } } } } ````