Create ticket (Admin)

POST/manage/events/:eventId/tickets

Create a ticket type. Requires the ticketsWrite permission. Paid tickets require price and paymentType, and the event must have Stripe Connect configured.

Auth	Login required

Path parameters

eventIdstringrequired

Event ID or slug.

Request body

pricenumberrequired

Price; an integer of 0 or more. For ONSITE_PAYMENT / PREPAID_STRIPE it must be 1 or more. It cannot be changed once sales have started.

paymentTypestringrequired

One of FREE / ONSITE_PAYMENT / PREPAID_STRIPE. PREPAID_STRIPE requires Stripe payments to be enabled for the event. It cannot be changed once sales have started.

namestringrequired

Ticket name. Up to 100 characters (surrounding whitespace is trimmed).

descriptionstringoptional

Description; up to 500 characters.

languagesLanguagesoptional

Localized name / description.

salesLimitnumberoptional

Sales limit; an integer of 0 or more. null means unlimited.

statusstringoptional

One of DRAFT / PUBLISHED / PRIVATE.

confirmUserBasicInfobooleanoptional

Whether to confirm basic profile info at purchase.

requiresApprovalbooleanoptional

Whether registration requires approval.

transferablebooleanoptional

Whether the ticket can be transferred.

invitationEnabledbooleanoptional

Whether invitations are enabled. It can only be set to true when the event's enabledReferralTree feature is on; sending true otherwise returns 400.

invitationTargetTicketIdstringoptional

Ticket ID issued through invitations; must belong to the same event. Required when invitationEnabled is true.

invitationMaxGenerations / invitationLimitnumberoptional

Invitation generation depth must be 1 or 2; the per-person invitation limit must be an integer of 1 or more.

invitationDiscountEnabled / invitationDiscountPercent / invitationDiscountAmountboolean | numberoptional

Invitation discount settings. When enabled, either percent (0–100) or amount (0 or more) is required. Discounts apply only when the target ticket is paid.

Notes

Invitation (referral) settings can only be specified when the event's enabledReferralTree feature is enabled. Because enabledReferralTree can only be turned on through the platform administration (admin) API, sending invitationEnabled: true for an event without it returns 400 (VALIDATION_ERROR).

Response

Returns Ticket.

Request

curl https://api.4s.link/manage/events/EVENT_ID/tickets \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "一般チケット",
  "price": 5000,
  "paymentType": "PREPAID_STRIPE",
  "salesLimit": 200,
  "status": "PUBLISHED"
}'

Example response

{
  "id": "t1a2b3c4-...",
  "name": "一般チケット",
  "description": "...",
  "price": 5000,
  "paymentType": "PREPAID_STRIPE",
  "salesLimit": 200,
  "status": "PUBLISHED",
  "confirmUserBasicInfo": true,
  "requiresApproval": false,
  "transferable": true,
  "invitationEnabled": false,
  "order": 0
}