--- sourceDocument: Zurich Build workflows sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/build-workflows Release : - zurich ft:locale : - en-US ft:publication_title : - Zurich Build workflows ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # Building spokes using Spoke Generator # Building spokes using Spoke Generator {#ariaid-title1} * Release version: Zurich * * Updated September 2, 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Building spokes using Spoke Generator Spoke Generator enables ServiceNow customers to automate integration tasks by creating custom reusable actions called spokes. These spokes simplify integration with third-party applications without requiring scripting. The feature requires an IntegrationHub subscription and appropriate licenses for IntegrationHub Professional Pack in production and sub-production environments. Show full answer Show less Spokes can be created by importing OpenAPI Specifications, Postman collections, or by manually building actions. This capability accelerates integration development and enhances workflow automation. ## Key Features * **Custom Spoke Creation:** Build spokes by importing OpenAPI Specs or Postman collections, using API documentation snippets with ServiceNow Otto, or manual creation. * **Reusable Actions:** Generate and add multiple reusable actions within spokes to automate complex integrations. * **User Roles and Permissions:** * Admins can create, import, publish, and maintain spokes and actions. * Action designers can add actions. * Users with read roles can view spokes and actions. * **Import Limits and Configuration:** * OpenAPI Spec import default size limit is 10 MB, configurable up to 100 MB. * Maximum supported API operations per spoke defaults to 500, configurable up to 1000. * **OpenAPI Step Limitations:** Only certain OpenAPI 3.0 components are supported; for example, complex schema constructs like oneOf, anyOf, discriminators, callbacks, and security schemes are not supported. * **Request Body Support:** Supports only JSON media types for request bodies. * **Dependencies:** Requires the ServiceNow IntegrationHub Starter Pack Installer plugin and relevant licenses. ## Practical Benefits for ServiceNow Customers * Streamlines the creation of integrations by allowing import from standard API formats and manual creation. * Reduces the need for custom scripting through configurable reusable actions. * Provides flexibility in managing integration complexity by allowing additional actions to be added to spokes. * Supports governance through role-based access controls for creating, editing, and viewing spokes and actions. * Offers configuration options to handle larger API specifications and more operations as needed. Automate integration tasks by creating a sequence of reusable actions to develop custom integrations called spokes. ## Request apps on the Store {#spoke-builder__section_tcg_rrx_zxb} Visit the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) website to view all the available apps, for information about submitting requests to the store, and to download and install Spoke Generator (sn_spoke_builder). For cumulative release notes information for all released apps, see the [ServiceNow Store version history release notes](https://www.servicenow.com/docs/r/store-release-notes/sn-store-release-notes.html). ## App dependencies {#spoke-builder__section_ntz_2rx_zxb} If you're having trouble installing the app, ensure that the dependent plugin, ServiceNow IntegrationHub Starter Pack Installer (com.glide.hub.integrations.starter) is installed. You need ServiceNow IntegrationHub Professional Pack Installer license in your prod and sub-prod environments for creating spokes using OpenAPI specification, Postman collection, or with AI. Note: Some of these plugins are licensable features and require appropriate licenses, if used outside the spoke implementation. ## Capabilities {#spoke-builder__section_gdk_qmx_zxb} An Integration Hub custom spoke provides both inbound and outbound integration with third-party applications. These integrations, referred to as spokes, are easy to configure and enable you to quickly add powerful actions without the need to write a script. This feature requires an Integration Hub subscription. For more information, see [Legal schedules - IntegrationHub overview](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf). You can build custom spokes for the required third-party application by importing an [OpenAPI Specification](https://www.servicenow.com/docs/GEH_lOdQcsA0rNl60WpPVg "Automate an integration and generate reusable actions by importing an OpenAPI Specification.") or [Postman collection](https://www.servicenow.com/docs/HC2pvTa2JlowbwJk~lYr3Q "Automate an integration and generate reusable actions by importing a Postman collection."), [documentation snippets from third-party API documentation](https://www.servicenow.com/docs/5QZ_6_GxOdIm~a7qgTV4gg "Use ServiceNow Otto in Spoke Generator to create spokes and actions by providing the required third-party API documentation snippet as an input."), or [creating a spoke manually](https://www.servicenow.com/docs/9ScqnD3Ya0MsHOoH783QHQ "Automate an integration and generate reusable actions manually."). ## Required user roles {#spoke-builder__section_np1_3ky_byb} * Users with the admin role can: * View the Spokes tab. * Create a new spoke. * Import an OpenAPI Specification. * Create connection alias. * Publish actions and save actions as drafts. * See spoke activity log. {#spoke-builder__ul_qzw_bly_byb} * Users with the action_designer and fd_read_actions roles can: * View the Spokes tab. * See actions in a spoke. {#spoke-builder__ul_z2v_tly_byb} * Users with the action_designer role can add actions. Note: Users with just the fd_read_actions role can only see actions. * Users with the flow_operator or flow_designer can view flows and subflows. {#spoke-builder__ul_btf_1ly_byb} ## OpenAPI Specification size limit {#spoke-builder__section_ssb_lmy_byb} By default, the system can import OpenAPI Specifications up to 10 MB. To increase the import size, update the glide.rest.openapi.max_request_size system property. The maximum value is 100 MB. ## Limitations of OpenAPI Specification {#spoke-builder__section_igf_l1g_dhb} Spoke actions created by importing OpenAPI specification, contain the OpenAPI step. Ensure that you are aware of these OpenAPI step limitations. Request body media types : The request body only supports JSON media types. Note: A string type output object is created when the OpenAPI schema has additionalProperties or no properties. OpenAPI 3.0 components : OpenAPI 3.0 adds new components to Swagger 2.0 to describe an API in further detail. OpenAPI support in the OpenAPI step supports some, but not all of these components. The OpenAPI step does not currently support these components. * Schema Object: oneOf, anyOf, additionalProperties properties * Discriminator Object * Info object: termsOfService, contact, license fields * Example Object * Link Object * Callback Object * Security Scheme Object * Security Requirements Object * Tag Object * External Documentation Object * Server Object * Specification extensions * Recursive references {#spoke-builder__ul_gtc_xbp_zhb} More information on these components is available in the OpenAPI documentation. See [OpenAPI Specification](https://swagger.io/specification/). Maximum number of operations supported : The number of API operations is limited to 500 by default. However, using the system property glide.rest.openapi.max_operation_limit, you can configure the number of operations from 1 through 1000. ## App version {#spoke-builder__section_d34_kgj_zyb} Spoke Generator v4.5.0 is the latest version. * **[Create spoke and build actions by importing an OpenAPI Specification](https://www.servicenow.com/docs/GEH_lOdQcsA0rNl60WpPVg)** Automate an integration and generate reusable actions by importing an OpenAPI Specification. * **[Create spoke and build actions by importing a Postman collection](https://www.servicenow.com/docs/HC2pvTa2JlowbwJk~lYr3Q)** Automate an integration and generate reusable actions by importing a Postman collection. * **[Use ServiceNow Otto to create spokes and build actions](https://www.servicenow.com/docs/5QZ_6_GxOdIm~a7qgTV4gg)** Use ServiceNow Otto in Spoke Generator to create spokes and actions by providing the required third-party API documentation snippet as an input. * **[Create spoke and build actions manually](https://www.servicenow.com/docs/9ScqnD3Ya0MsHOoH783QHQ)** Automate an integration and generate reusable actions manually. * **[Add more actions to the custom spoke](https://www.servicenow.com/docs/92SF5UFOoYMNS7fu0eWQ3A)** Add more reusable actions to your custom spoke to automate an integration.