Tickets / API reference

Create a ticket type

Add a free or paid ticket type to your event.

POST/events/{event}/ticket-types

Authentication

Send your live API key in the Authorization: Bearer header. All requests use https://api.celerlinks.com/api-service.

Request parameters

eventstring · path · required

ID of an event owned by this account.

namestring · body · required

Ticket name; up to 255 characters.

pricenumber · body · required

Price in NGN, not kobo. Use 0 for free admission.

quantityinteger · body · optional

Number of tickets available; minimum 1.

descriptionstring · body · optional

Optional ticket description.

sales_startstring · body · optional

ISO 8601 date/time.

sales_endstring · body · optional

Must be later than sales_start.

min_per_orderinteger · body · optional

Minimum tickets per order; at least 1.

max_per_orderinteger · body · optional

At least min_per_order.

Examples are illustrative. Catalogue IDs, product codes, prices, and provider-specific fields must come from your current API responses.

cURL request

curl --request POST 'https://api.celerlinks.com/api-service/events/YOUR_EVENT/ticket-types' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "General admission",
  "price": 5000,
  "quantity": 100
}'

Illustrative response

{
  "success": true,
  "message": "Request completed successfully",
  "data": {
    "ticket_type": {
      "id": 456,
      "name": "General admission",
      "price": 5000
    }
  }
}