Overview
The EMS Platform Services integration automatically imports room bookings from your EMS instance into your Localist calendar - no manual entry required. When a department reserves a room in EMS, that booking appears on your public calendar on a scheduled sync.
This integration connects to EMS Platform Services (the current REST-based version of EMS). If your institution is still running the legacy SOAP-based EMS, contact your Partner Success Manager at support@concept3d.com.
Who should use this: Event Managers who want to surface EMS room bookings on the Localist calendar.
Prerequisites
Before setting up the integration, gather the following from your EMS administrator:
- EMS Platform Services base URL (must be HTTPS)
- Client ID
- Client Secret
Step 1: Connect to EMS
- In the Localist admin, navigate to Feeds.
- Click Add Feed and select EMS Platform Services.
- Enter your EMS base URL, Client ID, and Client Secret.
- Click Test Connection. Localist will verify the credentials and display a success or error message.
- Once the test passes, click Create Feed. The feed is created in a disabled state while you complete configuration.
Updating Credentials
If your EMS credentials change, use the Reconnect button on the feed's configure page. This updates only the credentials - it does not disable the feed or reset any settings.
Step 2: Configure Filters and Mappings
After connecting, you will land on the EMS feed configure page. This is where you define which bookings import and how EMS classifications map to Localist.
Filters
Filters control which EMS bookings are included or excluded from the sync. Filter options are loaded live from your EMS instance.
| Filter | Description | Required? |
|---|---|---|
| Buildings | Include specific EMS buildings | Yes |
| Event Types | Include specific EMS event types | Yes |
| Statuses | Include or exclude specific EMS statuses | No |
| Group Types | Include or exclude specific EMS group types | No |
| Groups | Include or exclude specific EMS groups (departments/orgs) | No |
How include/exclude works: If you add an item to the include list, only bookings matching that item will import. If you add an item to the exclude list, bookings matching that item will be skipped. An item cannot appear on both lists.
If no include filters are set, all bookings are imported except those explicitly excluded.
Content Mappings
Content mappings define how EMS classifications translate to Localist equivalents. You can map:
- EMS Event Types -> Localist Event Type filters
- EMS Groups -> Localist Groups or Departments
- EMS Buildings -> Localist Places
For each mapping, select the EMS item on the left and the Localist destination on the right. Unmapped items import without a Localist classification applied.
Sync Settings
| Setting | Description |
|---|---|
| Event Creation Mode | Controls how EMS bookings become Localist events. One event per booking creates a separate Localist event for each EMS booking (default). Group bookings by room combines bookings that share the same room into a single Localist event with multiple instances - each instance represents one booking within a reservation. |
Step 3: Save and Run First Sync
Click Save to save the feed configuration. Localist will enable the feed and trigger the first import automatically.
After the first sync, bookings appear as events on your Localist calendar. Subsequent syncs run on the platform's scheduled feed import interval.
How EMS Data Appears in Localist
| EMS Field | Localist Field | Notes |
|---|---|---|
| BookingID | External ID | Used for deduplication - re-imports update existing events in place |
| EventName | Event Title | |
| TimeEventStart / TimeEventEnd | Start / End Date & Time | |
| Building + Room | Place + Room | Localist attempts to match the EMS building to an existing Place |
| EventTypeDescription | Event Type | Matched to existing Localist event type filters |
| GroupName | Group / Department | Applied via content mappings if configured |
EMS bookings that are cancelled after import remain on the Localist calendar. Deletion sync is not supported in the current version.
Troubleshooting
Test Connection fails
- Confirm the base URL is HTTPS. HTTP URLs are not accepted.
- Verify the Client ID and Client Secret are correct.
- Confirm your EMS instance is running EMS Platform Services (REST). The legacy SOAP API is not supported by this integration.
Catalog options (buildings, event types, etc.) are not loading
- Catalog data loads after the configure page renders. Wait a few seconds and refresh.
- If options still do not appear, use the Reconnect button to re-verify credentials.
Imported events are missing expected classifications
- Check that content mappings are configured for the relevant EMS groups, event types, or buildings.
- Unmapped items import without a Localist classification applied.
No events are importing
- Check that include filters are not set too narrowly. If include lists are set, only bookings matching those items will import.