Building partner integrations

Read time: 3 minutes

Last edited: Nov 04, 2024

Partner integrations is an Enterprise feature

Partner integrations is available to customers on an Enterprise plan. To learn more, read about our pricing. To upgrade your plan, contact Sales.

Overview

This topic explains how to build a LaunchDarkly integration as part of our partner program. You can join our Technology Partner Program to make your integrations publicly available.

Onboard with LaunchDarkly

Our Technology Partner Program empowers technology partners to build, launch, and go-to-market with LaunchDarkly. Benefits include partnership support, early product access, and joint marketing opportunities, among others.

To get started, visit our Partners page.

Audience Reach

We list partner integrations in the following locations:

The Integrations page of the LaunchDarkly application
The LaunchDarkly website
Our Integrations documentation for configuration and implementation documentation

You can also list your integration on your own websites and platforms.

Plan your integration

After you have completed the partner agreement, you can begin planning your integration.

As you plan, you may want to consider the following questions:

What value will your integration provide to your integration's users?
How will you measure your integration's success?
What is your plan your ongoing support of the integration?
How will you document the integration?

Connect your platform to LaunchDarkly

Next, decide how to connect your integration to LaunchDarkly. You can allow members to authenticate using an OAuth application or using API access tokens.

Authenticate using an OAuth application

LaunchDarkly must verify OAuth applications before customers can use them. OAuth also lets you limit the connection of your integrated app to individual members. To learn how, read OAuth applications.

Authenticate using API access tokens

We provide two types of API access tokens:

If you use API access tokens for authentication, we recommend using built-in or custom roles to limit the amount of access to LaunchDarkly those tokens have. If you don't use custom roles to limit API token access, your members will be able to edit everything in your LaunchDarkly account, which can be a security risk.

API access tokens and the principle of least privilege

As a best practice, we recommend giving your tokens the smallest scope required for your integration. For example, if your integration is not designed to modify your Production environment, use a custom role or inline policy to restrict access appropriately.

To learn how to use custom roles to limit access for an API tokens, read Scope personal API access tokens.

We also recommend storing your API access tokens securely.

Choose an integration option

If your integration is only interacting with LaunchDarkly resources, you may be able to build it entirely using the REST API. If you require a more complex integration, such as one with triggers or flag links, use the integration framework.

We require an integration framework update for any published integration. LaunchDarkly uses the manifest.json and associated image resources to surface your integration to end users.

Use the API

LaunchDarkly is built using an open REST API. Your integration can interact with LaunchDarkly in many of the same ways that you can through the user interface (UI). To learn how, read our API documentation.

Use the integration framework

LaunchDarkly's integration framework lets you build deeper integrations between LaunchDarkly and a third-party service.

A number of capabilities exist to provide integrations in both directions, such as sending partner-defined webhooks to third-party services or surfacing external feature flag-related links in the LaunchDarkly UI.

These capabilities are further outlined in the section below.

About integration capabilities

Your integration's capabilities are how it interacts with LaunchDarkly.

LaunchDarkly supports the following integration capabilities:

Here are the topics in this category: