Universe API Documentation
This is the complete API documentation for connecting to the Universe API using MindCloud's Universal API. If you are new to MindCloud, start with the Introduction to see how one API can sit in front of many different apps.
MindCloud is an integration company that offers one normalized API to access 3,100+ apps from a single place. It cleans up provider-specific quirks, keeps requests and responses consistent, and centralizes authentication so you do not need to manage separate flows for every app. Browse other apps.
Meet Universe: Universe GraphQL integration for hosts, events, attendees, orders, discount codes, access keys, rates, categories, countries, and check-in workflows. The app includes 34 actions with live-validated QA coverage plus clearly documented in-development endpoints that still require account permissions or fixture data. Keep reading to get started.
Quickstart
Before you run your first Universe request, you need three things:
- A MindCloud account — sign in or create an account at MindCloud.
- A MindCloud API Key — create one in API Keys. Keep it on your server.
- At least one Universe connection — create or choose one in Connections. Note its
connectionId.
Every Universe action uses the same URL pattern:
https://connect.mindcloud.co/v1/universal/universe/latest/actions/{actionSlug}You need a MindCloud API Key and a Universe connection. Then call an action such as Get Default Email Template:
curl --request GET \
--url "https://connect.mindcloud.co/v1/universal/universe/latest/actions/get-default-email-template" \
--header "Authorization: Bearer $MINDCLOUD_API_KEY" \
--get \
--data-urlencode "connectionId=$CONNECTION_ID"Every response comes back in the same envelope, with your rows in a data array:
{
"success": true,
"data": [
{ "id": "1042", "name": "Ava" }
],
"meta": {}
}After your first request works, use Shape your requests to control arguments, pagination, filtering, fields, and errors.
Authentication
Authentication has two layers. Your MindCloud API Key authenticates the request to MindCloud, sent as a Bearer token in the Authorization header. The connectionId selects the connected Universe account that should run the action. MindCloud stores and refreshes the Universe credentials behind that connection, so you never send provider tokens with your requests.
Pass connectionId in the query string for GET and DELETE actions, and in the JSON body for POST, PUT, and PATCH actions. Keep your MindCloud API Key on your server; do not ship it in browser code, mobile apps, public repositories, or logs.
Universe actions
All 34 published actions for this Universe version. Each page documents the endpoint, arguments, and response controls.
- PUTCheck In Order Item
- PUTCheck Out Order Item
- GETGet Default Email Template
- GETGet Discount
- GETGet Event
- GETGet Event Report
- GETGet Host
- GETGet Host Report
- GETGet Membership
- GETGet Order
- GETGet Order Item
- GETGet Profile
- GETGet Viewer
- GETList Available Permissions
- GETList Calendar Widgets
- GETList Categories
- GETList Email Templates
- GETList Event Access Keys
- GETList Event Attendees
- GETList Event Discount Codes
- GETList Event Orders
- GETList Event Questions
- GETList Event Rates
- GETList Event Referral Codes
- GETList Events
- GETList Host Attendees
- GETList Host Events With Tickets
- GETList Host Orders
- GETList Memberships
- GETList Stripe Countries
- GETList Stripe Currencies
- GETList User External Emails
- GETList Whitelisted Countries
- PUTUpsert Event Discounts
Related apps
More Support apps on the Universal API, behind the same REST shape. Or browse all apps.