This guide is for Webex administrators. With the Webex integration, a person booking a meeting in Spaceti can add a Webex meeting with one switch. Spaceti creates the meeting in your Webex, with the booker as the host, and puts the join link into the calendar invitation. When the booking is moved or cancelled, the Webex meeting follows.

Choose an option

Webex offers two ways to give Spaceti that access. Both give the people booking meetings the same experience.

	A – Delegated access	B – Organization access
How it works	Each user connects their own Webex account, and Spaceti acts only for that user	An administrator authorizes Spaceti once for the whole organization
Webex app type	Integration	Service App
Who sets it up	Any Webex user of your organization	A developer account and a Control Hub Full Administrator
What users do	Connect Webex once, and again every 90 days	Nothing
Meeting host	The connected Webex account	The booker, on the Webex sites you select
Best for	Pilots, a few teams, or organizations that prefer per-user consent	Company-wide rollout

In both options, every booker who wants a Webex meeting needs a Webex Meetings host licence, and the app you create lives in your own Webex developer account, under a name and icon you choose.

Before you start

Use a shared service account, not a personal one. A Webex app belongs to the account that creates it. Create it under a shared mailbox (for example webex-apps@yourcompany.com) that is a member of your Webex organization, so the app does not disappear when someone leaves.
Sign in to the Webex developer portal. Open developer.webex.com and sign in with that account.

Option A – Set up delegated access

This takes about ten minutes.

Create the Integration. In the developer portal, open the avatar menu → My Webex Apps → Create a New App → Create an Integration.
Fill in the name, icon and description. Users see the name and icon on the Webex consent screen, so something like “Spaceti Meetings” with your logo works well.
Add the redirect URIs. Add both of these exactly as written, because Webex requires an exact match:
```
https://auth.spaceti.com/webex/delegated/callback
```
```
spaceti://webex/delegated/callback
```
The first is for the Spaceti web app, the second for the iOS and Android apps.
Select the scopes. Tick exactly these three and nothing else:
- meeting:schedules_read – read the user's meetings created by Spaceti
- meeting:schedules_write – create, change and delete those meetings
- spark:people_read – identify which Webex account the user connected
Save and copy the credentials. Click Add Integration. On the next page, copy the Client ID and the Client Secret.
Check your Control Hub policy. If your organization allows only approved integrations (Control Hub → Management → Apps), allow the Integration you just created. Otherwise users are refused on the consent screen.

The Client Secret is shown only once. Store it in your password manager right away.

What to send to Spaceti (Option A)

Value	Where to find it
Client ID	On the Integration page
Client Secret	Shown when the Integration was created

What your users see

The first time someone adds a Webex meeting to a booking, Spaceti shows Connect Webex. They sign in to Webex, see your Integration's name and the permissions above, and accept. When Webex ends the connection, the button appears again and the user accepts once more.

Option B – Set up organization access

You create the app, a Full Administrator authorizes it in Control Hub (admin.webex.com), and you copy the resulting tokens. Webex then creates a technical account in your organization that schedules meetings on behalf of each booker.

Part 1 – Create the Service App (developer portal)

Create the Service App. Open the avatar menu → My Webex Apps → Create a New App → Create a Service App.
Fill in the name, icon, description and contact email. Your administrators see these in Control Hub when they authorize the app, so make them clear (for example “Spaceti Meetings – schedules Webex meetings for Spaceti bookings”).
Select the scopes. Tick exactly these two:
- meeting:admin_schedule_read
- meeting:admin_schedule_write
Webex adds spark:kms on its own, which is expected. No redirect URI is needed.
Save and copy the credentials. Copy the Client ID and the Client Secret (shown only once), and note the app's ID for Part 2.
Request authorization. On the Service App page, click Request Admin Authorization.

Part 2 – Authorize the app (Control Hub, Full Administrator)

Find the app. In Control Hub, go to Management → Apps → Service Apps → Other service apps tab. The search box finds apps by app ID only, not by name, so paste the ID from Part 1.
Authorize and pick the sites. Open the app, switch on Authorise, and under Select Webex sites tick every Webex site whose users will book meetings through Spaceti. Click Save. Bookers on other sites cannot get a Webex meeting.
Copy your Organization ID. Open Account and copy the Organization ID.

Part 3 – Collect the tokens (developer portal)

Open Org Authorizations. Back on the Service App page, scroll to Org Authorizations. Your organization is now listed.
Generate the tokens. Select your organization, paste the Client Secret, and generate the tokens.
Copy the Refresh Token. Spaceti uses it to obtain short-lived access tokens on its own, so you do not need to send the access token.

Make sure the emails match. Spaceti schedules each meeting for the Webex user with the same email address as the booker in Spaceti.

What to send to Spaceti (Option B)

Value	Where to find it
Client ID	On the Service App page
Client Secret	Shown when the Service App was created
Refresh Token	Under Org Authorizations (Part 3)
Organization ID	In Control Hub → Account
Webex site(s)	The site names you selected, for example `yourcompany.webex.com`

Send the values to Spaceti

Send the values to your Spaceti contact securely, for example as a one-time link from a password manager, never in plain email or chat. We check them against Webex, switch the integration on for your tenant and confirm back to you.

After go-live

Lost or regenerated Client Secret

Use Regenerate on the app page and send us the new secret the same secure way. Until we update it, Webex meetings cannot be created.

Refresh Token expiry (Option B)

Webex limits how long an organization authorization stays valid. Spaceti monitors it and contacts you in advance if a new Refresh Token is needed. You then repeat Part 3; no new authorization is required.

Deauthorizing

A Full Administrator can deauthorize the Service App in Control Hub, or delete the Integration in the developer portal, at any time. Spaceti stops offering Webex immediately, and existing meetings stay in Webex.

Switching between options

You can switch at any time: complete the other option's steps and send us the new values.