Background Agents

Connect Background Agent Account

Points the listed MCP servers at user_email's connected account and returns the link that connects each one — the automatable form of choosing "Connected account" in the agent's Tools tab and clicking Connect.

The agent's other MCP servers keep their existing authentication. The connection itself is only created once the returned link is opened by (or on behalf of) that account.

post/api/background-agents/{id}/auth-url

Request

Base URL: https://app.withwillow.ai
URL: https://app.withwillow.ai/api/background-agents/{id}/auth-url
Auth: HTTP bearer

Path parameters

idstring required

The ID of the background agent

Request body

integrationsstring[] required

Slugs of the MCP servers to connect

user_emailstring required

Email of the org member whose account the agent runs as

Response

Agent configured and connect links generated

Example response

{
  "data": {
    "auth_urls": [
      {
        "integration": "github",
        "user_email": "bot-github@acme.com",
        "url": "https://acme.withwillow.ai/acme/api/auth/init?state=..."
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.