integration_not_configured

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

• HTTP Status: 400 Bad Request

• Retryable: No

• Task State: FAILED

---

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

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

{
  "type": "https://docs.warp.dev/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

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.

---

Related

• Integrations — Integration setup guides

• Slack Integration — Slack-specific setup

• Linear Integration — Linear-specific setup