Luma: Post V1 Events Coupons Create

Create a coupon that can be applied when a guest is registering for an event.

Tool ID: luma_post_v1_events_coupons_create

Run this action

Use the TypeScript SDK for a single call. Put ctx.tools.execute(...) inside a Play when the call should be durable, scheduled, or run across a CSV.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'luma_post_v1_events_coupons_create',
  {
    "code": "example",
    "discount": {
      "discount_type": "percent",
      "percent_off": 100
    },
    "event_id": "event_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute luma_post_v1_events_coupons_create --input '{
  "code": "example",
  "discount": {
    "discount_type": "percent",
    "percent_off": 100
  },
  "event_id": "event_123"
}' --json

Example response

The SDK exposes this shape at result.toolResponse.raw. Values below are representative.

{
  "data": {
    "id": "id_123",
    "code": "example",
    "remaining_count": 123,
    "valid_start_at": "2026-01-15T12:00:00Z",
    "valid_end_at": "2026-01-15T12:00:00Z",
    "percent_off": 1,
    "cents_off": 1,
    "currency": "solana_sol"
  }
}

Use deepline tools get luma_post_v1_events_coupons_create --json for the latest machine-readable contract.

Input reference

Create a coupon that can be applied when a guest is registering for an event. Restrict it to a ticket type with event_ticket_type_id — when that ticket type is hidden, this creates an unlock (access) code. You are not able to edit the coupon terms after it has been created.

Name	Type	Required	Default	Details
`payload.code`	`string`	Yes	—	This is the code that the user will enter on the event page. It is not case sensitive. Maximum 20 characters. Minimum length: 1. Maximum length: 20.
`payload.remaining_count`	`integer`	No	—	Number of times the coupon can be used. Set to 1000000 for unlimited uses. Minimum: 0. Maximum: 1000000.
`payload.valid_start_at`	`string`	No	—	ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z Format: `date-time`.
`payload.valid_end_at`	`string`	No	—	ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z Format: `date-time`.
`payload.discount`	`object`	Yes	—	—
`payload.event_id`	`string`	Yes	—	Event ID, this usually starts with evt-
`payload.event_ticket_type_id`	`string`	No	—	Optional. Restrict the coupon to a single ticket type. If that ticket type is hidden, the coupon acts as an unlock (access) code that reveals the ticket during registration. Pair a hidden ticket type that has Require Approval turned off with an unlock code to let invited guests register and pay directly, skipping the Apply to Attend step. For a code that unlocks the ticket without changing the price, set the discount to 0% (`percent_off: 0`).

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.id`	`string`	Yes	—	—
`result.data.code`	`string`	Yes	—	This code is case insensitive.
`result.data.remaining_count`	`integer`	Yes	—	Minimum: -9007199254740991. Maximum: 9007199254740991.
`result.data.valid_start_at`	`string \| null`	Yes	—	ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z Format: `date-time`.
`result.data.valid_end_at`	`string \| null`	Yes	—	ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z Format: `date-time`.
`result.data.percent_off`	`number \| null`	Yes	—	—
`result.data.cents_off`	`number \| null`	Yes	—	—
`result.data.currency`	"solana_sol" \| "solana_usdc" \| "aed" \| "afn" \| "all" \| "amd" \| "ang" \| "aoa" \| "ars" \| "aud" \| "awg" \| "azn" \| "bam" \| "bbd" \| "bdt" \| "bgn" \| "bhd" \| "bif" \| "bmd" \| "bnd" \| "bob" \| "brl" \| "bsd" \| "bwp" \| "byn" \| "bzd" \| "cad" \| "cdf" \| "chf" \| "clp" \| "cny" \| "cop" \| "crc" \| "cve" \| "czk" \| "djf" \| "dkk" \| "dop" \| "dzd" \| "egp" \| "etb" \| "eur" \| "fjd" \| "fkp" \| "gbp" \| "gel" \| "ghs" \| "gip" \| "gmd" \| "gnf" \| "gtq" \| "gyd" \| "hkd" \| "hnl" \| "htg" \| "huf" \| "idr" \| "ils" \| "inr" \| "isk" \| "jmd" \| "jod" \| "jpy" \| "kes" \| "kgs" \| "khr" \| "kmf" \| "krw" \| "kwd" \| "kyd" \| "kzt" \| "lak" \| "lbp" \| "lkr" \| "lrd" \| "lsl" \| "mad" \| "mdl" \| "mga" \| "mkd" \| "mmk" \| "mnt" \| "mop" \| "mur" \| "mvr" \| "mwk" \| "mxn" \| "myr" \| "mzn" \| "nad" \| "ngn" \| "nio" \| "nok" \| "npr" \| "nzd" \| "omr" \| "pab" \| "pen" \| "pgk" \| "php" \| "pkr" \| "pln" \| "pyg" \| "qar" \| "ron" \| "rsd" \| "rub" \| "rwf" \| "sar" \| "sbd" \| "scr" \| "sek" \| "sgd" \| "shp" \| "sle" \| "sos" \| "srd" \| "std" \| "szl" \| "thb" \| "tjs" \| "tnd" \| "top" \| "try" \| "ttd" \| "twd" \| "tzs" \| "uah" \| "ugx" \| "usd" \| "uyu" \| "uzs" \| "vnd" \| "vuv" \| "wst" \| "xaf" \| "xcd" \| "xof" \| "xpf" \| "yer" \| "zar" \| "zmw"	Yes	—	Allowed: `solana_sol`, `solana_usdc`, `aed`, `afn`, `all`, `amd`, `ang`, `aoa`, `ars`, `aud`, `awg`, `azn`, `bam`, `bbd`, `bdt`, `bgn`, `bhd`, `bif`, `bmd`, `bnd`, `bob`, `brl`, `bsd`, `bwp`, `byn`, `bzd`, `cad`, `cdf`, `chf`, `clp`, `cny`, `cop`, `crc`, `cve`, `czk`, `djf`, `dkk`, `dop`, `dzd`, `egp`, `etb`, `eur`, `fjd`, `fkp`, `gbp`, `gel`, `ghs`, `gip`, `gmd`, `gnf`, `gtq`, `gyd`, `hkd`, `hnl`, `htg`, `huf`, `idr`, `ils`, `inr`, `isk`, `jmd`, `jod`, `jpy`, `kes`, `kgs`, `khr`, `kmf`, `krw`, See the live schema for the complete constraint.
`result.data.event_ticket_type_id`	`string \| null`	No	—	The ticket type this coupon is restricted to, if any. Set for unlock (access) codes that reveal a hidden ticket type.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

Get started

Build and automate

Common workflows

Data and integrations

Reference

Luma: Post V1 Events Coupons Create

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation