Creating a Custom Integration

Create a custom integration to write Code Issues or Alert Sources to using OpsLevel's API or UI.

To send your own alert sources, code issue projects, and code issues using the OpsLevel API, you must attach them to a Custom Integration. You can create your Custom Integration via UI or API.

To create with the UI, add a new integration tile of the type "Custom." You'll need to provide a name for your integration.


To create with the API, use the command below:

mutation($name: String!) {
    customIntegrationCreate(input: {
      name: $name,
    }) {
      integration {
        id
        __typename
        name
      }
      errors {
        message
        path
      }
    }
  }
  
# Variables 
{ 
  name: "my custom data provider"
}

If you created the integration via API, you can get your integration ID as follows:

query getIntegrations {
  account {
    integrations {
      nodes {
        id
        __typename
        name
      }
    }
  }
}

Once you've created your integration, you can send Code Issues and Alert Sources to it using the OpsLevel API.