Oracle Cloud Infrastructure Documentation

Create an Instance Using the User Interface

Create an Oracle Integration instance in a selected compartment using the Oracle Cloud Console.

Before you create a service instance

Note the following points before creating your Oracle Integration instance:

  • For the list of regions in which you can create an Oracle Integration instance and the options and features available in those regions, see Availability.
  • For information on restrictions when creating an Oracle Integration instance, see Restrictions.
  • Ensure that the compartment you plan to use for your Oracle Integration instance has been created. See Learn Best Practices for Setting Up Your Tenancy. To create a compartment, see Create a compartment in the Oracle Cloud Infrastructure documentation.
  • During instance creation, your Oracle Integration 3 instance is associated with an Oracle Cloud Infrastructure Identity and Access Management (IAM) identity domain, either the one you're signed into or one you select in the advanced options. You can't change the identity domain association after instance creation.
  • The steps here apply to Oracle Integration 3 and Oracle Integration for SaaS. Differences in instance creation are noted. For more information about the SaaS version, see Oracle Integration for Oracle SaaS.

Create a service instance

  1. After signing in to the Oracle Cloud Console, note your selected region.

    For information about regions, see Regions and Availability Domains.

  2. Open the navigation menu and click Developer Services. Under Application Integration, click Integration.
  3. Next to Applied filters, make sure you're viewing the compartment in which you want to create the instance. If you aren't, click the compartment, expand the hierarchy of compartments, select the one you want, and click Apply filter. Compartments can contain other compartments. If you created a new compartment or were recently given access to a compartment, it might take several minutes for the compartment to appear.
    Note

    Do not create your instance in the root or ManagedCompartmentForPaaS compartment.

    The page is refreshed to show any existing instances in that compartment.

  4. Click Create instance.
  5. Enter the following details:
    Field Description

    Name

    Enter a name for this instance. The name becomes part of the URL for accessing the instance.

    Tags

    Optionally, add tags to help you organize your resources in your tenancy. Click Add tag to get started. See Resource Tags.

    Version

    Shows that you're creating a Oracle Integration 3 instance.

    You can no longer create a new Oracle Integration Generation 2 instance.

    Note: Oracle Integration Generation 2 was discontinued on August 31, 2025. You must upgrade any Oracle Integration Generation 2 instances to Oracle Integration 3.

    Consumption model

    Typically, only one consumption model is displayed, but if multiple consumption models are available in your tenancy, select the one you want to use for this instance:

    • Universal credits

      Note: The Healthcare edition is available only in tenancies that use Universal Credits.

    • Subscription (OIC4SaaS)
    • Oracle Integration Government

    Edition

    Select the edition you want this instance to be:

    • Standard: Includes integrations, standard adapters, recipes and accelerators, Visual Builder, and File Server.
    • Enterprise: Includes all the features of Standard edition, plus additional technologies and services, including enterprise adapters, and enables you to design, automate, and manage your business processes in the cloud with Process Automation, perform UI-based automation with robots using robotic process automation, and support business-to-business communications using B2B for Oracle Integration. This edition also supports disaster recovery.
    • Healthcare: Includes all the features of Enterprise edition, plus additional technologies for Health Level 7 (HL7), including an MLLP adapter, a FHIR adapter, and healthcare action. This edition also supports disaster recovery.

      Note: The Healthcare edition is available only in tenancies that use Universal Credits.

    See Oracle Integration Editions to see what's licensed in each edition.

    Shape

    Select a shape for this instance—Development or Production.

    • Development: Use this shape only for building and testing. Development instances get updated first, so you can try new features early and catch any issues before they reach production.
    • Production: Use this shape for your production workload. Support for production instances is prioritized. Updates roll out approximately three weeks after development instances, so you have time for testing on development.

    Notes:

    • The production shape is available in all regions. The development shape is available in select regions. See Development Shape Availability.
    • Customer-managed disaster recovery is available in both shapes. Oracle-managed disaster recovery is available only in production shape.
    • You can't split a single instance into two shapes. Instead, you must create separate instances for each shape.
    • You can't change the shape after you create the instance. However, you can move data to another instance using the export and import features. See Clone the Design-Time Metadata of an Entire Service Instance in Using Integrations in Oracle Integration 3.

    License type

    Note: If you are provisioning Oracle Integration for SaaS, this field is read-only and displays Subscribe to a new Oracle Integration license. Each message pack for Oracle Integration for SaaS includes 1 million billing messages per month.

    Select a license type for this instance.

    • Subscribe to a new Oracle Integration license: Select this option if you want to purchase a new license.

      With this option, each message pack includes 5,000 billing messages per hour.

    • Existing Oracle Fusion Middleware license (BYOL): Select this option if you want to use your existing license.

      With this option, each message pack includes 20,000 billing messages per hour.

      Note: This option isn't available if you selected the Healthcare edition.

    Message packs

    Message pack size is based on the type of Oracle Integration license you selected.

    • For Oracle Integration:
      If you created a new Oracle Integration license in the cloud:
      • Each message pack includes 5,000 billing messages per hour.
      • You can subscribe to up to 100 message packs.
      If you brought an existing Oracle Fusion Middleware license to the cloud (BYOL):
      • Each message pack includes 20,000 billing messages per hour.
      • You can subscribe to up to 100 message packs.
    • For Oracle Integration for SaaS:
      • Each message pack includes 1 million billing messages per month. Usage is tracked on a monthly basis instead of hourly, which keeps costs predictable even when you have unpredictable hourly volumes.
      • You can subscribe to up to 43 message packs.
    Note:

    Access token

    If this field is displayed, you are trying to create an instance as a non-federated user. Sign in as a federated user and restart creating an instance.
  6. You might also want to configure some advanced options:
    Field Description

    Identity domain

    If you created additional identity domains to hold different user populations, you can associate this Oracle Integration instance with one of those secondary identity domains. This allows you to manage all your instances from a single domain (the one you're currently signed into), rather than having to sign into each domain separately.

    Enter the information for the secondary identity domain to which you want to associate the instance.

    • Compartment: The compartment you select here is the one that includes the secondary identity domain, not the one in which the instance will be created. The instance will be created in the compartment you selected in step 3.
    • Domain: Select the secondary identity domain you want to associate with this instance.

      Note: You must have read permission for the secondary identity domain. If you don't, the secondary identity domain administrator needs to add an IAM policy such as the following:

      Allow group primary_identity_domain/group_name to read domains in compartment secondary_identity_domain_compartment

      See Managing Policies and Details for IAM with Identity Domains.

    If you configure a secondary identity domain, Oracle Integration creates an Oracle Cloud service in the secondary identity domain when it provisions your Oracle Integration 3 instance. If you don't configure a secondary identity domain, the Oracle Cloud service is created in the primary identity domain—the one you're signed into.

    After the Oracle Integration 3 instance has been created in the secondary identity domain, you need to assign administrators the ServiceAdministrator role in the Oracle Cloud service that was created. See Assign Roles to Groups.

    Network access

    Configure an allowlist for your instance. See Configure an Allowlist for Your Instance.

    Disaster recovery

    If you want to configure disaster recovery, select Enable disaster recovery. This installs a primary instance in one region and a secondary instance in another region. To see this option, you must have selected Enterprise or Healthcare as the edition and Production as the shape, and you must be in a region that supports disaster recovery pairing.

    See Introduction to Oracle-Managed Disaster Recovery in Configuring an Oracle-Managed Disaster Recovery Solution for Oracle Integration 3.

    Security attributes

    Configure Oracle Cloud Infrastructure Zero Trust Packet Routing (ZPR) security attributes for your instance. See Assign ZPR Security Attributes to Your Instance.

  7. Click Create.
    If you have any issues trying to create an instance, see Troubleshoot Oracle Integration Instance Creation.
When instance creation completes successfully, the instance shows as Active in the State column.

Once created, an instance is visible only in the region in which it was created.

Troubleshoot Oracle Integration Instance Creation

This topic provides some tips for troubleshooting Oracle Integration instance creation.

Oracle Integration 3 is not available to all users or Missing parameter (isByol)

If you receive the error "Missing parameter (isByol)" when you click Create, perform the following steps:
  1. Ensure you can see the Oracle Integration service in the Oracle Cloud Console.
    1. In the Oracle Cloud Console, open the navigation menu and click Identity & Security. Under Identity, click Domains.
    2. Open your domain. The default domain is OracleIdentityCloudService.
    3. In the tabs across the top, click Oracle cloud services.
    4. Search for Integration for the Oracle Integration service:
      • For Oracle Integration, you should see INTEGRATIONCAUTO.
      • For Oracle Integration for SaaS, you should see INTEGRATIONSUB.
    5. If you see the Oracle Integration service, submit a Service Request to Oracle Support.

      If you don't see it, move on to the next step.

  2. If you don't see the Oracle Integration service, confirm that your Cloud Account Administrator activated the Oracle Integration service (by clicking the link in the email titled "XXX").
  3. If the administrator didn't activate the service, have them do so, then try again to create an Oracle Integration instance.
  4. If your Cloud Account Administrator already tried to activate the service or didn't receive the email, contact your account manager to confirm you have a subscription for Oracle Integration.

401: Authorization failed or 404: Not Found

If you click the Oracle Integration instance name just after creating the instance and receive a 401: Authorization failed or a 404: Not Found error, instance creation might still be in progress. Wait a minute and try again.