How to assign speakers and moderators to a session

Use this guide when you need to attach speaker or moderator accounts to an existing session.

Important prerequisite — speaker/moderator flag must be set first

Before an account can be attached to a session as a speaker or moderator, the account must already have the speaker or moderator flag enabled at the event level. The POST /api/v2/sessions/set endpoint does not set this flag automatically — it only attaches accounts that already have the flag.

Step 1 — Enable the flag on the account:

Bash

# Set speaker flag on an account
curl -X POST "https://your-event-domain.com/api/v2/account/set" \
  -H "Authorization: Bearer your_api_key_here" \
  -F "event_id=7" \
  -F "id=18629" \
  -F "speaker=true"

Bash

# Set moderator flag on an account
curl -X POST "https://your-event-domain.com/api/v2/account/set" \
  -H "Authorization: Bearer your_api_key_here" \
  -F "event_id=7" \
  -F "id=18630" \
  -F "moderator=true"

See the "How to assign or remove a speaker or moderator role" guide under POST account/set for details.

Step 2 — Attach them to the session:

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 "id=42" \
  -F "speakers[]=18629" \
  -F "moderators[]=18630"

Response

JSON

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

If an account does not have the speaker/moderator flag set, no error is returned but the attachment will not take effect. Always verify step 1 was completed successfully before proceeding.

Remove speakers or moderators

To clear all speakers or moderators from a session, pass an empty value:

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 "id=42" \
  -F "speakers[]="

Notes

speakers[] and moderators[] accept account IDs or email addresses
Both can be updated in the same request
You can also retrieve all speakers for an event using GET /api/v2/sessions/getSpeakers