Create draft coupon

POST

/api/v2.0/stores/{storeId}/coupon

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://api.diller.app/api/v2.0/stores/your-store-id/coupon"),
    Headers =
    {
        { "Authorization", "Bearer <token>" },
    },
    Content = new StringContent("{ \"external_ids\": [ { \"platform\": \"example\", \"external_id\": \"example\" } ], \"code\": \"example\", \"title\": \"example\", \"description\": \"example\", \"valid_from\": \"2026-09-11T12:34:49\", \"valid_to\": \"2026-09-11T12:34:49\", \"type\": \"Standard\", \"discount_type\": \"NotDefined\", \"discount_value\": 1, \"max_redemptions\": 1, \"redemption_rules\": [ { \"channel\": \"example\", \"product_ids\": [ \"example\" ], \"category_ids\": [ \"example\" ] } ] }")
    {
        Headers =
        {
            ContentType = new MediaTypeHeaderValue("application/json")
        }
    }
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://api.diller.app/api/v2.0/stores/your-store-id/coupon"

  payload := strings.NewReader("{ \"external_ids\": [ { \"platform\": \"example\", \"external_id\": \"example\" } ], \"code\": \"example\", \"title\": \"example\", \"description\": \"example\", \"valid_from\": \"2026-09-11T12:34:49\", \"valid_to\": \"2026-09-11T12:34:49\", \"type\": \"Standard\", \"discount_type\": \"NotDefined\", \"discount_value\": 1, \"max_redemptions\": 1, \"redemption_rules\": [ { \"channel\": \"example\", \"product_ids\": [ \"example\" ], \"category_ids\": [ \"example\" ] } ] }")

  req, _ := http.NewRequest("POST", url, payload)

  req.Header.Add("Authorization", "Bearer <token>")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{ \"external_ids\": [ { \"platform\": \"example\", \"external_id\": \"example\" } ], \"code\": \"example\", \"title\": \"example\", \"description\": \"example\", \"valid_from\": \"2026-09-11T12:34:49\", \"valid_to\": \"2026-09-11T12:34:49\", \"type\": \"Standard\", \"discount_type\": \"NotDefined\", \"discount_value\": 1, \"max_redemptions\": 1, \"redemption_rules\": [ { \"channel\": \"example\", \"product_ids\": [ \"example\" ], \"category_ids\": [ \"example\" ] } ] }");
Request request = new Request.Builder()
  .url("https://api.diller.app/api/v2.0/stores/your-store-id/coupon")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build();

Response response = client.newCall(request).execute();

import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://api.diller.app/api/v2.0/stores/your-store-id/coupon',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  data: {
    external_ids: [{platform: 'example', external_id: 'example'}],
    code: 'example',
    title: 'example',
    description: 'example',
    valid_from: '2026-09-11T12:34:49',
    valid_to: '2026-09-11T12:34:49',
    type: 'Standard',
    discount_type: 'NotDefined',
    discount_value: 1,
    max_redemptions: 1,
    redemption_rules: [{channel: 'example', product_ids: ['example'], category_ids: ['example']}]
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://api.diller.app/api/v2.0/stores/your-store-id/coupon';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"external_ids":[{"platform":"example","external_id":"example"}],"code":"example","title":"example","description":"example","valid_from":"2026-09-11T12:34:49","valid_to":"2026-09-11T12:34:49","type":"Standard","discount_type":"NotDefined","discount_value":1,"max_redemptions":1,"redemption_rules":[{"channel":"example","product_ids":["example"],"category_ids":["example"]}]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.diller.app/api/v2.0/stores/your-store-id/coupon \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "external_ids": [ { "platform": "example", "external_id": "example" } ], "code": "example", "title": "example", "description": "example", "valid_from": "2026-09-11T12:34:49", "valid_to": "2026-09-11T12:34:49", "type": "Standard", "discount_type": "NotDefined", "discount_value": 1, "max_redemptions": 1, "redemption_rules": [ { "channel": "example", "product_ids": [ "example" ], "category_ids": [ "example" ] } ] }'

Creates a new draft coupon for the store.

Authorizations

OAuth2

Parameters

Path Parameters

storeId

required

string

Example

your-store-id

Request Body

object

external_ids

Array<object>

nullable

object

platform

string

nullable

external_id

This is the ID the cupon has in the external system / platform.

string

nullable

code

string

nullable

title

required

string

>= 1 characters

description

string

nullable

valid_from

required

The startDate of the coupon

string format: date-time

Example

2026-09-11T12:34:49

valid_to

string format: date-time

nullable

Example

2026-09-11T12:34:49

type

required

These are the types of coupons that can be created via API.

string

Allowed values: Standard Welcome Public Birthday ChildBirthday PointsToCurrency

discount_type

string

Allowed values: NotDefined Percentage Fixed FreeShipping OverridePrice

discount_value

number format: double

max_redemptions

integer format: int32

redemption_rules

A collection of rules that define where and how the coupon can be redeemed. Each rule specifies the applicable channel, products, and categories for coupon usage.

Array<object>

nullable

Represents a rule for coupon redemption, defining the applicable channels, products, and categories.

object

channel

The sales channel where the coupon can be redeemed. Valid values include ‘Pos’ (Point of Sale) for in-store purchases and ‘OnlineStore’ for online purchases.

string

nullable

product_ids

A list of product IDs that the coupon applies to. If specified, the coupon can only be used for these products.

Array<string>

nullable

category_ids

A list of product category IDs that the coupon applies to. If specified, the coupon can only be used for products within these categories.

Array<string>

nullable

object

external_ids

Array<object>

nullable

object

platform

string

nullable

external_id

This is the ID the cupon has in the external system / platform.

string

nullable

code

string

nullable

title

required

string

>= 1 characters

description

string

nullable

valid_from

required

The startDate of the coupon

string format: date-time

Example

2026-09-11T12:34:49

valid_to

string format: date-time

nullable

Example

2026-09-11T12:34:49

type

required

These are the types of coupons that can be created via API.

string

Allowed values: Standard Welcome Public Birthday ChildBirthday PointsToCurrency

discount_type

string

Allowed values: NotDefined Percentage Fixed FreeShipping OverridePrice

discount_value

number format: double

max_redemptions

integer format: int32

redemption_rules

A collection of rules that define where and how the coupon can be redeemed. Each rule specifies the applicable channel, products, and categories for coupon usage.

Array<object>

nullable

Represents a rule for coupon redemption, defining the applicable channels, products, and categories.

object

channel

The sales channel where the coupon can be redeemed. Valid values include ‘Pos’ (Point of Sale) for in-store purchases and ‘OnlineStore’ for online purchases.

string

nullable

product_ids

A list of product IDs that the coupon applies to. If specified, the coupon can only be used for these products.

Array<string>

nullable

category_ids

A list of product category IDs that the coupon applies to. If specified, the coupon can only be used for products within these categories.

Array<string>

nullable

object

external_ids

Array<object>

nullable

object

platform

string

nullable

external_id

This is the ID the cupon has in the external system / platform.

string

nullable

code

string

nullable

title

required

string

>= 1 characters

description

string

nullable

valid_from

required

The startDate of the coupon

string format: date-time

Example

2026-09-11T12:34:49

valid_to

string format: date-time

nullable

Example

2026-09-11T12:34:49

type

required

These are the types of coupons that can be created via API.

string

Allowed values: Standard Welcome Public Birthday ChildBirthday PointsToCurrency

discount_type

string

Allowed values: NotDefined Percentage Fixed FreeShipping OverridePrice

discount_value

number format: double

max_redemptions

integer format: int32

redemption_rules

A collection of rules that define where and how the coupon can be redeemed. Each rule specifies the applicable channel, products, and categories for coupon usage.

Array<object>

nullable

Represents a rule for coupon redemption, defining the applicable channels, products, and categories.

object

channel

The sales channel where the coupon can be redeemed. Valid values include ‘Pos’ (Point of Sale) for in-store purchases and ‘OnlineStore’ for online purchases.

string

nullable

product_ids

A list of product IDs that the coupon applies to. If specified, the coupon can only be used for these products.

Array<string>

nullable

category_ids

A list of product category IDs that the coupon applies to. If specified, the coupon can only be used for products within these categories.

Array<string>

nullable

Responses

200

application/json

Array<object>

object

integer format: int32

external_ids

Array<object>

nullable

object

platform

string

nullable

external_id

This is the ID the cupon has in the external system / platform.

string

nullable

code

required

string

>= 1 characters

status

string

nullable

title

required

string

>= 1 characters

description

string

nullable

article_number

string

nullable

valid_from

required

The startDate of the coupon

string format: date-time

valid_to

required

string format: date-time

type

required

string

Allowed values: Standard Welcome Campaign Public Recurring Birthday ChildBirthday Automation PointsToCurrency StampCard

discount_type

string

Allowed values: NotDefined Percentage Fixed FreeShipping OverridePrice

discount_value

number format: double

max_redemptions

integer format: int32

image_url

string

nullable

product_ids

DEPRECATED: This property is being phased out and should no longer be used. Please use the property ‘RedemptionRules’.

Array<string>

nullable

redemption_rules

A collection of rules that define where and how the coupon can be redeemed. Each rule specifies the applicable channel, products, and categories for coupon usage.

Array<object>

nullable

Represents a rule for coupon redemption, defining the applicable channels, products, and categories.

object

channel

The sales channel where the coupon can be redeemed. Valid values include ‘Pos’ (Point of Sale) for in-store purchases and ‘OnlineStore’ for online purchases.

string

nullable

product_ids

A list of product IDs that the coupon applies to. If specified, the coupon can only be used for these products.

Array<string>

nullable

category_ids

A list of product category IDs that the coupon applies to. If specified, the coupon can only be used for products within these categories.

Array<string>

nullable

target

Defines where the coupon can be applied to. The filters are cumulativelly applied.

object

required_points

integer format: int32

membership_level

integer format: int32

nullable

list_id

integer format: int32

nullable

usage_extension_in_days

integer format: int32

Example

[
  {
    "valid_from": "2026-09-11T12:34:49",
    "valid_to": "2026-09-11T12:34:49",
    "type": "Standard",
    "discount_type": "NotDefined"
  }
]

400

Bad Request

application/json

object

type

string

nullable

title

string

nullable

status

integer format: int32

nullable

detail

string

nullable

instance

string

nullable

errors

object

key

additional properties

Array<string>

key

additional properties

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  }
}

Create draft coupon

Authorizations

Parameters

Path Parameters

Example

Request Body

Example

Example

Example

Example

Example

Example

Responses

200

Example

400

Examplegenerated

Example^generated