Create Event

Create a new event with ticket tiers

POST /api/events

cURL

curl -X POST https://api.gatepass.app/api/events \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Tech Conference 2026",
    "description": "Annual technology conference featuring industry leaders",
    "venue": "San Francisco Convention Center",
    "address": "747 Howard St",
    "city": "San Francisco",
    "country": "USA",
    "latitude": 37.7842,
    "longitude": -122.4016,
    "startDate": "2026-06-15T09:00:00Z",
    "endDate": "2026-06-15T18:00:00Z",
    "category": "conference",
    "image": "https://example.com/event-image.jpg",
    "chainId": 137,
    "tiers": [
      {
        "name": "Early Bird",
        "description": "Limited time discount tickets",
        "price": 99,
        "quantity": 100,
        "maxPerPerson": 2
      },
      {
        "name": "General Admission",
        "description": "Standard conference access",
        "price": 149,
        "quantity": 500,
        "maxPerPerson": 5
      },
      {
        "name": "VIP",
        "description": "VIP access with exclusive workshops",
        "price": 299,
        "quantity": 50,
        "maxPerPerson": 3
      }
    ]
  }'

201 Created

{
  "event": {
    "id": "clx1234567890abcdef",
    "title": "Tech Conference 2026",
    "description": "Annual technology conference featuring industry leaders",
    "venue": "San Francisco Convention Center",
    "address": "747 Howard St",
    "city": "San Francisco",
    "country": "USA",
    "latitude": 37.7842,
    "longitude": -122.4016,
    "source": "gatepass",
    "externalUrl": null,
    "eventDate": "2026-06-15T09:00:00.000Z",
    "saleStart": "2026-03-06T12:00:00.000Z",
    "saleEnd": "2026-06-15T18:00:00.000Z",
    "totalSupply": 650,
    "ticketPrice": 99,
    "currency": "USD",
    "maxPerWallet": 5,
    "contractAddress": null,
    "chainId": 137,
    "imageUrl": "https://example.com/event-image.jpg",
    "metadataUri": null,
    "category": "CONFERENCE",
    "tags": "",
    "isPublic": true,
    "allowTransfers": true,
    "requireKYC": false,
    "status": "PUBLISHED",
    "organizerId": "clx0987654321fedcba",
    "createdAt": "2026-03-06T12:00:00.000Z",
    "updatedAt": "2026-03-06T12:00:00.000Z"
  }
}

This endpoint requires authentication and organizer role.

Authentication

Include the JWT token in the Authorization header:

Authorization: Bearer YOUR_JWT_TOKEN

Request Body

title · string · required

Event title

description · string

Detailed event description

venue · string · required

Venue name

address · string

Full street address

city · string

City name

country · string

Country name

latitude · number

Venue latitude coordinate

longitude · number

Venue longitude coordinate

startDate · string · required

Event start date/time in ISO 8601 format

endDate · string

Event end date/time in ISO 8601 format. Defaults to 2 hours after start if not provided.

category · string

Event category. Options: conference, concert, workshop, networking, festival, sports, theater, other

image · string

Event image URL

contractAddress · string

Blockchain contract address for NFT tickets

chainId · number

Blockchain chain ID. Default: 137 (Polygon)

metadataUri · string

IPFS or HTTP URL to ticket metadata

tiers · array

Array of ticket tier objects

Show Tier Object

name · string · required

Tier name (e.g., “General Admission”, “VIP”)

description · string

Tier description and benefits

price · number · required

Ticket price in USD

quantity · number · required

Available quantity for this tier

maxPerPerson · number

Maximum tickets per person. Default: 5

ticketPrice · number

Fallback ticket price if no tiers are specified

maxCapacity · number

Maximum event capacity if no tiers are specified

Response

event · object

The created event object

Show Event Object

id · string

Unique event identifier

title · string

Event title

description · string

Event description

venue · string

Venue name

address · string

Street address

city · string

City

country · string

Country

latitude · number

Latitude coordinate

longitude · number

Longitude coordinate

eventDate · string

Event start date/time

saleStart · string

Ticket sale start date/time

saleEnd · string

Ticket sale end date/time

totalSupply · number

Total ticket capacity

ticketPrice · number

Minimum ticket price

currency · string

Currency code (default: USD)

contractAddress · string

NFT contract address

chainId · number

Blockchain chain ID

imageUrl · string

Event image URL

category · string

Event category

status · string

Event status (PUBLISHED, DRAFT, CANCELLED)

isPublic · boolean

Whether event is publicly visible

organizerId · string

ID of the organizer user

createdAt · string

Creation timestamp

cURL

curl -X POST https://api.gatepass.app/api/events \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Tech Conference 2026",
    "description": "Annual technology conference featuring industry leaders",
    "venue": "San Francisco Convention Center",
    "address": "747 Howard St",
    "city": "San Francisco",
    "country": "USA",
    "latitude": 37.7842,
    "longitude": -122.4016,
    "startDate": "2026-06-15T09:00:00Z",
    "endDate": "2026-06-15T18:00:00Z",
    "category": "conference",
    "image": "https://example.com/event-image.jpg",
    "chainId": 137,
    "tiers": [
      {
        "name": "Early Bird",
        "description": "Limited time discount tickets",
        "price": 99,
        "quantity": 100,
        "maxPerPerson": 2
      },
      {
        "name": "General Admission",
        "description": "Standard conference access",
        "price": 149,
        "quantity": 500,
        "maxPerPerson": 5
      },
      {
        "name": "VIP",
        "description": "VIP access with exclusive workshops",
        "price": 299,
        "quantity": 50,
        "maxPerPerson": 3
      }
    ]
  }'

201 Created

{
  "event": {
    "id": "clx1234567890abcdef",
    "title": "Tech Conference 2026",
    "description": "Annual technology conference featuring industry leaders",
    "venue": "San Francisco Convention Center",
    "address": "747 Howard St",
    "city": "San Francisco",
    "country": "USA",
    "latitude": 37.7842,
    "longitude": -122.4016,
    "source": "gatepass",
    "externalUrl": null,
    "eventDate": "2026-06-15T09:00:00.000Z",
    "saleStart": "2026-03-06T12:00:00.000Z",
    "saleEnd": "2026-06-15T18:00:00.000Z",
    "totalSupply": 650,
    "ticketPrice": 99,
    "currency": "USD",
    "maxPerWallet": 5,
    "contractAddress": null,
    "chainId": 137,
    "imageUrl": "https://example.com/event-image.jpg",
    "metadataUri": null,
    "category": "CONFERENCE",
    "tags": "",
    "isPublic": true,
    "allowTransfers": true,
    "requireKYC": false,
    "status": "PUBLISHED",
    "organizerId": "clx0987654321fedcba",
    "createdAt": "2026-03-06T12:00:00.000Z",
    "updatedAt": "2026-03-06T12:00:00.000Z"
  }
}