Skip to main content
POST
/
api
/
events
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
      }
    ]
  }'
{
  "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
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
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
      }
    ]
  }'
{
  "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"
  }
}

Build docs developers (and LLMs) love