Waiting for engine...
Skip to main content

Find the right API

Boomi provides multiple service areas, each designed for a different capability of the Boomi Platform.

If you are not sure where to start, use this guide to identify the service area that best matches your use case.

Whichever service area you choose, you need credentials first. Refer to Authenticating your API.

Quick reference​

If you want to...Use
Automate integration processes and platform resourcesPlatform APIs
Query and mutate data with a single flexible endpointGraphQL APIs
Manage partner subaccounts on behalf of your customersPlatform Partner APIs
Create, configure, or run AI agentsAgentstudio APIs
Manage models and golden recordsData Hub APIs
Move and transform dataData Integration APIs
Package and promote assetsBundles APIs
Manage connector resourcesConnector APIs
Retrieve audit informationAudit Log Staging APIs
Subscribe to platform eventsEvent Notifications APIs
Manage managed file transfersMFT APIs
Manage business Glossaries and metadataMeta Hub APIs
Govern APIs, gateways, and developer portalsAPI Control Plane APIs
Embed Spaces marketplaces and catalogs in your applicationSpaces Embed Service APIs

When to use an API instead of the user interface​

You can do most Boomi work in the Boomi Enterprise Platform user interface. APIs give you a second way in, from your own code. This lets you automate repetitive work, apply the same change across many objects at once, and connect Boomi to the systems you already use.

Use an API when you want to:

  • Trigger a process from another system, such as a CI/CD pipeline, a service desk, or your own application
  • Repeat an administrative task across many objects, such as deploying one package to every environment in an account
  • Pull execution, audit, or account data into your own monitoring and reporting tools
  • Provision accounts, users, or environments as part of an automated workflow

Work with integration processes​

Use Platform APIs if you want to:

  • Automate tasks that you normally perform in the Boomi Enterprise Platform UI
  • Create, update, execute, or delete integration processes
  • Create and manage platform resources, such as components, connections, environments, Runtimes, and Runtime clusters
  • Monitor process executions
  • Manage accounts, users, API tokens, and other platform resources

Available API styles

  • REST – For most automation and integration scenarios
  • GraphQL – For flexible querying and retrieving only the data you need
  • SOAP – For compatibility with existing SOAP-based integrations

Work with GraphQL APIs​

Use GraphQL APIs if you want to:

  • Query and mutate data through a single endpoint, requesting only the fields you need
  • Work across multiple service areas without learning a separate REST reference for each one

GraphQL is available for the following service areas. Each links to its own Operations (queries and mutations) and Types reference:

Service areaOperationsTypes
PlatformOperationsTypes
BundlesOperationsTypes
Event Streams AdminOperationsTypes
Event Streams QueryOperationsTypes
Partner PortalOperationsTypes
Agent Control TowerOperationsTypes
API MetricsOperationsTypes
Catalog ServiceOperationsTypes

Manage partner subaccounts​

Use Platform Partner APIs if you want to:

  • Manage secondary accounts (subaccounts) on behalf of your customers
  • Create and delete subaccounts, in addition to standard Platform API operations
  • Override the authenticated account to run a request against a specific subaccount
  • Cancel executions or provision accounts across the account hierarchy you manage

Work with AI agents​

Use Agent Garden APIs if you want to:

  • Create, configure, deploy, or manage AI agents
  • Manage the tools and sources an agent can use, including installing or uninstalling integration, hub, OpenAPI, prompt, and MCP tools
  • Package an agent configuration and deploy it to a target environment
  • Invoke an agent session at runtime, including sending file attachments as part of the conversation

Work with golden records​

Use Data Hub APIs if you want to:

  • Create and manage models, domains, sources, and repositories
  • Create, query, and update golden records
  • Review and resolve quarantined records

Move and transform data​

Use Data Integration APIs if you want to:

  • Create, run, and manage data pipelines
  • Manage data pipeline connections and environments
  • Monitor pipeline runs and retrieve run history

Package and promote assets​

Use Bundles APIs if you want to:

  • Create and manage bundles
  • Promote assets across environments

Work with connectors​

Use Connector REST APIs if you want to:

  • Create and manage connector resources
  • Upload connector archives and versions, and validate connector descriptor files
  • Manage connector groups, classifications, and icons
  • Submit and manage connector release, version change, version review, and visibility requests
  • Create, update, and retrieve connector metadata

Retrieve audit information​

Use Audit Log Staging APIs if you want to:

  • Retrieve audit events and operational history
  • Submit a blob audit log request, check its processing status, and cancel it if needed

Subscribe to platform events​

Use Event Notifications APIs if you want to:

  • Subscribe to and receive platform event notifications
  • Create, update, and delete event subscriptions for your account, including bulk operations
  • Retrieve available destination types, event types, and log levels
  • Create an Event Streams topic and subscription

Manage managed file transfers​

Use MFT APIs if you want to:

  • Create and manage Managed File Transfer resources
  • Automate Managed File Transfer operations

Manage business metadata​

Use Meta Hub REST APIs if you want to:

  • Create, update, delete, and search business Glossaries and their definitions
  • Track glossary publication and endorsement workflows, including endorsement history
  • Create, retrieve, and delete Associations between metadata objects

Govern APIs, gateways, and developer portals​

Use API Control Plane APIs if you want to:

  • Manage APIs, API Products, and their versions, specifications, and documentation
  • Register and monitor API Gateways, environments, and Agents across cloud and on-premises data planes
  • Manage Developer Portals, including pages, menus, and self-service registration
  • Manage users, organizations, subscriptions, and API governance rulesets

Embed Spaces in your application​

Use Spaces Embed Service REST APIs if you want to:

  • Embed Boomi Spaces marketplaces and publisher catalogs directly into your application
  • Launch embedded Spaces sessions and retrieve the caller's embed identity
  • Onboard, look up, update, and activate or deactivate OEM partner records
  • Resolve embed redirect URLs and platform tokens for embedded child users

Still not sure?​

If you are trying to automate actions that you normally perform in the Boomi Enterprise Platform user interface, start with Platform APIs.

If you are working with a specific Boomi capability, such as Agent Garden, Data Hub, or Managed File Transfer, choose the corresponding service area for that capability.

Each API overview includes getting started guides, authentication information, and links to the complete API reference. For a single list of all Boomi APIs, refer to View All APIs.

On this Page