Skip to main content
POST
/
speakers
/
{speaker_id}
/
session.json
Add sessions to speaker (JSON body)
curl --request POST \
  --url https://api.swoogo.com/api/v1/speakers/{speaker_id}/session.json \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_ids": [
    123
  ]
}
'
{
  "id": 101,
  "event_id": 12,
  "contact_id": 77,
  "cfs_speaker": false,
  "email": "john.doe@example.com",
  "bio": "Seasoned speaker in tech events.",
  "first_name": "John",
  "prefix": "Mr.",
  "last_name": "Doe",
  "company": "Tech Solutions",
  "middle_name": "Andrew",
  "job_title": "CTO",
  "work_phone": "+1 123-456-7890",
  "mobile_phone": "+1 987-654-3210",
  "suffix": "Jr.",
  "profile_picture": "https://example.com/uploads/speakers/101.jpg",
  "twitter_handle": "@john_doe",
  "gender": {
    "id": null,
    "value": null
  },
  "birth_date": "1985-06-15",
  "cc_email": "assistant@example.com",
  "vat_number": "123456789",
  "created_at": "2025-01-15 10:30:00",
  "direct_link": "https://conference.example.com/event12/speaker/101/john-doe",
  "updated_at": "2025-04-01 14:45:00",
  "event_sort": 2,
  "sessions": [
    {
      "id": 201,
      "event_id": 12,
      "name": "Opening Keynote",
      "admin_short_name": "",
      "badge_name": "",
      "description": "<p>Welcome session</p>",
      "date": "2025-06-01",
      "start_time": "09:00:00",
      "end_time": "10:00:00",
      "times_with_timezone": "9:00 AM - 10:00 AM (EST)",
      "use_event_timezone": true,
      "timezone": "America/New_York",
      "capacity": null,
      "notes": null,
      "location": null,
      "location_id": null,
      "track": null,
      "track_id": null,
      "session_included": false,
      "locked_when_saved": false,
      "selected_by_default": false,
      "prevent_session_conflicts": true,
      "session_status": "live",
      "type_id": null,
      "webinar_url": null,
      "direct_link": "https://conference.example.com/event12/session/201/opening-keynote",
      "virtual_link": null,
      "created_at": "2025-03-01 08:00:00",
      "updated_at": "2025-03-15 09:00:00"
    }
  ]
}

Authorizations

Authorization
string
header
required

OAuth 2.0 bearer token obtained from POST /oauth2/token. Tokens expire after 30 minutes. Include in the Authorization header as Bearer {access_token}.

Path Parameters

speaker_id
integer
required

integer - required - The ID of the speaker you want to associate sessions with

Example:

3

Body

application/json
session_ids
integer[]
required

array of integers - required - The list of session IDs to associate with the speaker

Response

Speaker updated with associated sessions

id
integer
Example:

101

event_id
integer
Example:

12

contact_id
integer
Example:

77

cfs_speaker
boolean
Example:

false

email
string
Example:

"john.doe@example.com"

bio
string
Example:

"Seasoned speaker in tech events."

first_name
string
Example:

"John"

prefix
string
Example:

"Mr."

last_name
string
Example:

"Doe"

company
string
Example:

"Tech Solutions"

middle_name
string
Example:

"Andrew"

job_title
string
Example:

"CTO"

work_phone
string
Example:

"+1 123-456-7890"

mobile_phone
string
Example:

"+1 987-654-3210"

suffix
string
Example:

"Jr."

profile_picture
string
Example:

"https://example.com/uploads/speakers/101.jpg"

twitter_handle
string
Example:

"@john_doe"

gender
object
birth_date
string
Example:

"1985-06-15"

cc_email
string
Example:

"assistant@example.com"

vat_number
string
Example:

"123456789"

created_at
string<date-time>
Example:

"2025-01-15 10:30:00"

Example:

"https://conference.example.com/event12/speaker/101/john-doe"

updated_at
string<date-time>
Example:

"2025-04-01 14:45:00"

event_sort
integer
Example:

2

sessions
object[]