Create Objects

APIs related to creating Limio Objects

Create Promo Code Objects

post

This API allows you to create a new promo code object in Limio. Only promo codes v2 are supported.

Authorizations

bearerAuth

AuthorizationstringRequired

To create a Bearer token, see How to get an OAuth Bearer Token?.

Usage format: Bearer <token>

Body

application/json

namestringRequired

The object name. Not included values will not be updated and nested values will require the structure to update. Updates will only occur for the id provided. WARNING! Changing this field might break integrations

Example: abc123

idstringRequired

The object id. This is the record_type and name concatenated such as promo_code_v2-abc123. Not included values will not be updated and nested values will require the structure to update. Updates will only occur for the id provided. WARNING! Changing this field might break integrations

Example: promo_code_v2-abc123

dataone ofRequired

or

Responses

200

OK

application/json

idstringOptional

The ID of the object

Example: promo_code_v2-CODE123

namestringOptional

The name of the object

Example: CODE123

statusstringOptional

The status of the object

Example: active

record_typestringOptional

The record type of the object

Example: promo_code_v2

servicestringOptional

The service of the object

Example: limio

dataobjectOptional

The data of the object sent in the request

Example: {"promoStartDate":"2024-10-07"}

400

Bad request (missing required fields)

401

Unauthorized

application/json

404

Not found

post

/objects/limio/promo_codes_v2

HTTPcURLJavaScriptPython

POST /api/objects/limio/promo_codes_v2 HTTP/1.1
Host: your-environment.prod.limio.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 449

{
  "name": "abc123",
  "id": "promo_code_v2-abc123",
  "data": {
    "applicationLevel": "wholeBasket",
    "promoCode": "abc123",
    "status": true,
    "description": "",
    "promoStartDate": "2024-11-11",
    "promoExpiryDate": "2024-12-31",
    "productDetails": {
      "product": {
        "path": "/products/Discounts"
      },
      "ratePlan": {
        "path": "'30% Off Monthly' 1 month only"
      }
    },
    "usage": {
      "availableQuantity": 100
    },
    "discount": {
      "discountType": "text",
      "percentageDiscount": 12,
      "durationLength": 1,
      "durationType": "Months"
    }
  }
}

{
  "id": "promo_code_v2-CODE123",
  "name": "CODE123",
  "status": "active",
  "record_type": "promo_code_v2",
  "service": "limio",
  "data": {
    "promoStartDate": "2024-10-07"
  }
}