How to create a participant category

Use this guide when you need to add a new participant category to an event via the API.

Prerequisites

Your API key
The event_id of the event

Request

Bash

curl -X POST "https://your-event-domain.com/api/v2/account/setCategory" \
  -H "Authorization: Bearer your_api_key_here" \
  -F "event_id=7" \
  -F "name=VIP Guest"

Response

JSON

{
  "code": 200,
  "errors": null,
  "data": {
    "id": 42,
    "status": "created"
  },
  "response_id": "1700000000.12345"
}

Store the returned id — you'll need it to assign participants to this category using POST /api/v2/account/set.

Optional: create as a buyer category

If you want this category to be a buyer category (enabling hosted buyer features), pass is_buyer=true:

Bash

curl -X POST "https://your-event-domain.com/api/v2/account/setCategory" \
  -H "Authorization: Bearer your_api_key_here" \
  -F "event_id=7" \
  -F "name=Hosted Buyer" \
  -F "is_buyer=true"