Skip to content
Warp

integration_not_configured

Open in ChatGPT ↗
Ask ChatGPT about this page
Open in Claude ↗
Ask Claude about this page
Copied!

The integration's setup is incomplete. Visit the setup URL to finish configuring the integration.

The integration_not_configured error occurs when a task requires an integration whose setup has not been completed (for example, missing OAuth tokens or unfinished configuration steps).

Details

Section titled “Details”
  • HTTP Status: 400 Bad Request
  • Retryable: No
  • Task State: FAILED

When does this occur?

Section titled “When does this occur?”

This error is returned when:

  • An integration (Slack, Linear, etc.) was partially set up but the configuration was not completed
  • Required OAuth tokens or credentials for the integration are missing or expired
  • The integration was installed but additional setup steps were not finished

Additional metadata fields

Section titled “Additional metadata fields”

This error includes extra fields beyond the standard response format:

  • integration_name — The name of the integration that needs configuration
  • setup_url — A URL to the integration setup page where you can complete configuration

Example response

Section titled “Example response”
{
  "type": "/reference/api-and-sdk/troubleshooting/errors/integration-not-configured/",
  "title": "Slack integration is not configured",
  "status": 400,
  "instance": "/api/v1/agent/tasks",
  "error": "Slack integration is not configured",
  "retryable": false,
  "integration_name": "slack",
  "setup_url": "https://oz.warp.dev/integrations"
}

How to resolve

Section titled “How to resolve”
  1. Visit the setup_url provided in the response metadata (or go to the Oz integrations page).
  2. Complete all setup steps for the integration.
  3. Retry the triggering event or task.
Section titled “Related”