Create an API Integration

Overview

This page walks Technology Partners through creating a Datadog API integration.

API integrations

Use Datadog API endpoints to enrich the customer’s experience by submitting data from your backend and pulling data from a user’s Datadog account. Technology Partners write and host their code within their environment.

API integrations are ideal for Technology Partners that are SaaS-based, and have an existing platform that authenticates users.

API integrations can send the following types of data to Datadog:

You can include out-of-the-box assets such as monitors, dashboards, and log pipelines with your Agent-based integration. When a user clicks Install on your integration tile, they are prompted to follow the setup instructions, and all out-of-the-box dashboards will appear in their account. Other assets, such as log pipelines, will appear for users after proper installation and configuration of the integration.

To display your offering on the Integrations or Marketplace page, you need to create a tile (pictured below). This tile will include instructions on how to set up your offering, as well as general information on what the integration does and how to use it.

A tile representing an example offering on the Integrations page

Development process

OAuth

Instead of requesting API and Application keys directly from a user, Datadog requires using an OAuth client to handle authorization and access for API-based integrations. OAuth implementations must support all Datadog sites.

For more information, see OAuth for Integrations and Authorization Endpoints.

To get started, you can explore examples that use OAuth in the integrations-extras repository such as Vantage.

Build your integration

The process to build an API-based integration looks like the following:

  1. Once you’ve been accepted to the Datadog Partner Network, you will meet with the Datadog Technology Partner team to discuss your offering and use cases.
  2. Request a Datadog sandbox account for development.
  3. Begin development of your integration, which includes writing and hosting the integration code on your end as well as implementing the OAuth protocol.
  4. Test your integration, as well as your OAuth client, in your Datadog sandbox account.
  5. Once your development work is tested and complete, follow the steps in Create a Tile in order to display your integration on the Integrations or Marketplace page.
  6. Once your pull request is submitted and approved, the Datadog Technology Partner team will schedule a demo for a final review of your integration.
  7. You will have the option of testing the tile and integration in your Datadog sandbox account before publishing, or immediately publishing the integration for all customers.

Start building your API integration by creating a tile.

Further reading

Additional helpful documentation, links, and articles:

Learn how to use the Datadog APIDOCUMENTATION more more Learn about using OAuth for API integrationsDOCUMENTATION more more Learn how to develop on the Datadog platformDOCUMENTATION more more