Skip to main content

Webex Events (formerly Socio)

Webex Events (formerly Socio) Integration Guide

Overview

This guide explains how to connect Bridged with Webex Events (formerly Socio) to read event content including attendee data, agenda/session information, speaker profiles, exhibitor details, and sponsor information. The integration supports reading this data for activation, qualification, and nurture playbooks where event context is needed.

Webex Events is an event technology platform acquired by Cisco that helps organizations manage in-person, virtual, and hybrid events. The platform provides a GraphQL API for programmatic access to event data .

Primary Use Case: Read Event Content

For Bridged's event experience integrations, the primary use case is reading event-related data, including:

Data Type

Use in Bridged

Attendee data

Personalize outreach and qualification conversations

Agenda/Session data

Answer attendee questions about schedules

Speaker profiles

Provide speaker bios and session information

Exhibitor/Sponsor data

Support exhibitor-related queries

Groups

Segment attendees by category

Prerequisites

Before starting, ensure you have:

  • A Webex Events (Socio) account with admin access

  • API access enabled for your organization (requires Webex Suite Enterprise Agreement or contacting support)

  • Organization admin permissions to create API keys

⚠️ Important: API access is not automatically available. If you're not a Webex Suite Enterprise Agreement customer, you must contact Webex Events support to request API access .

Step 1: Verify API Access

API access is automatically included for Webex Suite Enterprise Agreement (Suite EA) customers. For all other customers, contact your Webex Events representative or support team to request API access .

When API access is enabled, a new API tab appears in the Organization settings page .

Step 2: Create an API Key

  1. Log in to your Webex Events platform

  2. Click your profile image in the top right corner → Organization settings

  3. Click the API tab in the left menu

  4. Click Create key

  5. Enter a Label for the API key (e.g., "Bridged Integration")

  6. Select the API version (current version pre-selected)

  7. Click Save

  8. Copy the API key immediately and store it securely

⚠️ Warning: This is the only time the full API key can be accessed. After closing the modal, the full key cannot be retrieved again .

Step 3: Configure Bridged to Connect to Webex Events

  1. Log in to your Bridged dashboard

  2. Navigate to the Integrations section. If you do not see this section, contact support@bridged.media

  3. Click Webex EventsConnect Account

  4. Enter the following credentials:

Field

Description

API Key

Your Webex Events API key

API Endpoint

https://api.webexevents.com/graphql (or platform-specific endpoint)

  1. Click Connect

Step 4: Understanding the GraphQL API

Webex Events uses a GraphQL API, not REST. This means you query exactly the data you need using GraphQL query syntax .

Basic Query Example

graphql

query EventsConnection($first: Int) {
    eventsConnection(first: $first) {
        edges {
            cursor
            node {
                id
                name
                groups {
                    id
                    name
                }
            }
        }
    }
}

Query with Variables

graphql

query GetEventSessions($eventId: ID!) {
    event(id: $eventId) {
        id
        name
        sessions {
            id
            title
            startTime
            endTime
        }
    }
}

Variables:

json

{
    "eventId": "YOUR_EVENT_ID"
}

Step 5: Available Data Types

Based on Webex Events API documentation, the following data can be read :

Data Type

GraphQL Operations

Key Fields

Events

Read, Update (no create/delete)

id, name, groups

Attendees

Create, Update, Read

name, email, groups, phone, social accounts

Sessions

Create, Update, Read, Delete

title, description, start/end time, speakers

Speakers

Create, Update, Read, Delete

name, bio, company, photo

Sponsors/Exhibitors

Create, Update, Read, Delete

name, description, logo, website

Groups

Create, Update, Read, Delete

exclusive/non-exclusive groups

Locations (Regions)

Create, Update, Read, Delete

room/area names

Event App Components

The API can also read Event App features including :

  • Agenda

  • Sponsors

  • Speakers

  • Exhibitors

  • Live Stream

  • Custom Lists

  • My QR Code

Step 6: Configure Sync Settings

Setting

Options

Description

Data objects

Events, Attendees, Sessions, Speakers, Sponsors, Groups

Which event data to read

Sync frequency

Hourly, Daily, Weekly

How often to refresh data

GraphQL query

Custom or Default

Define which fields to fetch

Bulk sync limit: Each bulk operation is limited to 50 records per request.

Pagination

GraphQL queries use cursor-based pagination with first and after parameters:

graphql

query {
    eventsConnection(first: 50, after: "cursor_value") {
        edges {
            cursor
            node { id name }
        }
        pageInfo {
            hasNextPage
            endCursor
        }
    }
}

Step 7: Alternative - Invite Developers to API Sandbox

If you need to test the integration without affecting real event data, Webex Events provides an API sandbox environment :

  1. When you create your first API key, an API team is automatically created

  2. Invite developers to this API team

  3. Team members get access to a separate sandbox environment for testing

  4. Sandbox data does not affect production events

Note: All new members of the API Sandbox team must create a new platform account for the sandbox, even if they already have a production account .

Common Use Cases

Playbook

How Event Data Is Used

Activation

Read attendee list to trigger pre-event reminders and session alerts via WhatsApp

Qualification Agent

Read attendee registration data and group assignments for lead scoring

Nurture & Conversion

Read session, speaker, and exhibitor information for post-event follow-up conversations

Example Conversation Powered by Webex Events Data

When an attendee asks "What sessions are tomorrow?", Bridged:

  1. Reads session data via GraphQL query

  2. Filters sessions by date

  3. Returns schedule information conversationally

Limitations & Considerations

Limitation

Impact

Workaround

API access requires Suite EA or support request

Not self-service

Contact Webex Events support

Cannot create Events via API

Events must be created manually

Use manual event setup before reading data

Cannot delete Attendees

Attendees can only be blocked, not deleted

Use block functionality instead

API requests are metered

Rate limits apply

Reduce sync frequency if hitting limits

GraphQL learning curve

Requires GraphQL knowledge

Use provided query templates

Rate Limiting & Performance

  • API requests are metered and limited to prevent abuse

  • SDK retry logic: Automatic retries for 408, 409, 429, 502, 503, 504 status codes

  • Rate limit handling: When receiving 429 (SecondBasedQuotaIsReachedError), the SDK reads the X-Secondly-Retry-After header for retry timing

  • Bulk operations: Maximum 50 records per request

Security & Permissions

  • API keys are created and managed by organization admins only

  • API keys can be labeled for different use cases (e.g., one key per team)

  • API team members have read-only access to the API sandbox by default

  • API keys cannot be retrieved after creation; store securely

  • All API calls should be made over TLS 1.2+

Idempotency for Mutations

For mutation operations (create/update/delete), the API supports idempotency keys to safely retry requests without duplicate operations :

text

Idempotency-Key: <unique_key>

Troubleshooting

Issue

Likely cause

Solution

No API tab in Org settings

API access not enabled

Contact Webex Events support

Connection fails (401)

Invalid API key

Verify key was copied correctly; keys cannot be retrieved after creation

Query returns no data

Wrong Event ID or missing product activation

Activate Event App product before API can modify it

Rate limiting (429)

Too many requests

Reduce sync frequency; check X-Secondly-Retry-After header

Cannot create Event

API limitation

Create Event manually in platform first

Attendee not deletable

API limitation

Use block functionality instead of delete

Support

For integration support, contact your Bridged account manager or email support@bridged.media.

For Webex Events-specific questions:

  • Webex Events Help Center: https://help.socio.events

  • API Documentation: Available in Organization Settings → API tab

  • Support Email: support@socio.events

  • API access requests: Contact Webex Events support