Skip to main content

Step 6: Preparing Your Integration for the Integration Marketplace

In this step you'll prepare the integration you created for the integration marketplace. Once the integration has been added to your integration marketplace, your customers can activate it for themselves. The can do that by logging in to Prismatic using customer users, or if you embed the marketplace in your app, they can activate the integration without leaving your app.

Adding a logo#

Integrations in the marketplace look best with a logo. Since this is a Slack integration, it makes sense to use the Slack logo. Right-click this image and click "Save As" to save a copy locally:

Slack icon

Next, open your integration back up and click the image icon to the left of your integration's name. Select the Slack icon you just downloaded to make that the icon for this integration.

Add icon to integration in Prismatic app

Give your integration a category#

Click the Description button at the top of your integration and give your integration a category and description. This will help your customers filter and find your integration easier.

Since this is a Slack integration, a category of "communication" makes sense, but you can choose whatever category you want.

Add category to integration in Prismatic app

Clean up config variables#

For integrations with few config variables, this may not be necessary, but it's nice to organize required config variables with headers. Click the Config Variables button within your integration again to open the config variables drawer. Add two headers by clicking the + Header button - one for reading "Slack Info" and another reading "Todo App Info". That'll give your customers a more polished configuration experience when they deploy this integration:

Clean up config variables in Prismatic app

You can preview what the config experience will look like by clicking into the TEST RUNNER drawer and selecting the Configuration tab:

Preview config experience in Prismatic app

Re-publish your integration#

Open the VERSION HISTORY drawer and SAVE & PUBLISH a new version of this integration that includes your config variable and icon changes.

Republish integration in Prismatic app

Add your integration to the integration marketplace#

Click Integration Marketplace on the left-hand sidebar and select + Integration.

Add integration to integration marketplace vis Prismatic app

Select your published integration from this list, and then give your marketplace offering an Overview:

Configur integration overview for integration marketplace via Prismatic app

Click UPDATE when you are ready.

Let customers activate this integration#

Now, you can either add customer users to Prismatic and let them activate this integration, or you can embed marketplace in your own app so users can seamlessly activate integrations without having to leave your app.

Your integration within an embedded marketplace would look like this:

Sample list of integrations in embedded marketplace

Clicking on the integration brings customers to a screen with the description and overview you set:

Activate integration from embedded marketplace

If a customer chooses to activate this integration, their configuration experience looks clean and straight-forward, thanks to the changes you made to the configuration experience (above):

Configure integration from embedded marketplace

Next Steps#

You are now ready to create your own integrations. Here are a few things we recommend you try next: