Integrating with IBM UrbanCode Deploy

IBM® UrbanCode Deploy applications and components can be integrated into IBM UrbanCode Release.

Before you begin

Use IBM UrbanCode Deploy to generate a token, and ensure that the server is available and you have its URL.


  1. Click Integrations > Add New to open the New Integration Provider pane.
  2. In the Name field, type a name for the integration.
  3. From the Integration list, select IBM UrbanCode Deploy.
  4. From the Frequency list, select a frequency. The frequency determines how often IBM UrbanCode Deploy is polled for changes. If IBM UrbanCode Deploy has numerous applications and components, frequent updates might affect performance. A frequency of 30 min is a good initial choice. You can run manual updates at any time.
  5. In the Base IBM UrbanCode Deploy URL field, enter the URL where the IBM UrbanCode Deploy server is located. The format is [HOST]:[PORT]; for example,
  6. In the Administrator Auth Token field, enter or paste an authentication token that is generated by IBM UrbanCode Deploy. Authentication tokens are created with the IBM UrbanCode Deploy Token page (Settings > Tokens).
    Note: The token must be generated for the admin user.
  7. Optional: Test the connection by clicking Connect. If the connection is successful, a Connection Successful message is displayed. Otherwise, use the View Log command to view information about the error.
  8. To run an immediate manual integration, click Run Integration.
  9. Click Save to save your work.


IBM UrbanCode Deploy applications and components are integrated into IBM UrbanCode Release. All version and snapshot statuses are synchronized between IBM UrbanCode Deploy and IBM UrbanCode Release.