How to create a session with a full profile

How to create a session with a full profile

Use this guide when you want to create a session with all common fields populated in a single request.


What you'll need before starting

What you need

Where to get it

Language ID

GET /api/v2/sessions/getLanguages

Track ID

GET /api/v2/sessions/getTracks?event_id=

Type ID

GET /api/v2/sessions/getTypes?event_id=

Hall ID (optional)

GET /api/v2/sessions/getLocations?event_id=

Tag IDs (optional)

GET /api/v2/sessions/getTags?event_id=

Participant category IDs for visibility (optional)

GET /api/v2/account/getCategories?event_id=


Request

Bash
curl -X POST "https://your-event-domain.com/api/v2/sessions/set" \
  -H "Authorization: Bearer your_api_key_here" \
  -F "event_id=7" \
  -F "title=Opening Keynote" \
  -F "description=The annual opening keynote address welcoming all attendees." \
  -F "language=1" \
  -F "track=2" \
  -F "type=3" \
  -F "date=2030-06-15" \
  -F "startTime=09:00" \
  -F "endTime=10:00" \
  -F "hall_id=5" \
  -F "capacity=200" \
  -F "price=0" \
  -F "isActive=true" \
  -F "isFeatured=true" \
  -F "tags[]=12" \
  -F "tags[]=13"

Response

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

Notes

  • capacity=0 means unlimited attendance

  • price=0 means the session is free

  • tags[] accepts an array of tag IDs. Pass tags[]= with an empty value to clear all tags on update

  • Always check the errors array — some field issues are non-fatal and the session will still be created