For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inTry it free
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
  • Integrations
    • Collaboration tools
    • Data Export
    • Edge tools
    • Environments as a service
    • Experimentation and metric integrations
    • Internal developer platforms
    • Monitoring tools
    • Segments integrations
    • Workflow management tools
    • More integrations
    • Managing integrations
    • Using the LaunchDarkly integration framework
    • Building partner integrations
      • Getting started
      • Defining an integration manifest
      • Registering a LaunchDarkly OAuth client
      • Using form variables
      • Using integration framework capabilities
      • Validating an integration
Sign inTry it free
LogoLogo
On this page
  • Overview
  • Onboard with LaunchDarkly
  • Audience Reach
  • Plan your integration
  • Connect your platform to LaunchDarkly
  • Authenticate using an OAuth application
  • Authenticate using API access tokens
  • Choose an integration option
  • Use the API
  • Use the integration framework
  • About integration capabilities
  • Related content
Integrations

Building partner integrations

Was this page helpful?
Previous

Getting started

Next
Built with
Partner integrations are available to customers on select plans

Partner integrations are only available to customers on select plans. 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:

  • Personal access tokens
  • Service tokens

If you use API access tokens for authentication, we recommend using roles to limit the amount of access to LaunchDarkly those tokens have. If you don’t use 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 role or inline policy to restrict access appropriately.

To learn how to use 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:

  • Approvals
  • Change history events hook
  • Endpoints
  • Feature stores
  • Flag links
  • Reserved custom properties
  • Synced segments
  • Triggers

Related content

Here are the topics in this category:

  • Getting started
  • Defining an integration manifest
  • Registering a LaunchDarkly OAuth client
  • Using form variables
  • Using integration framework capabilities
  • Validating an integration