> ## 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"
}
}
}
}
}
````