Skip to main content
Questions or issues? Contact us at api-support@manus.ai.

Setup

Before using a connector via the API, authorize it in the Manus web app:
  1. Go to your integrations page on manus.im.
  2. Click the connector you want to add and complete the OAuth flow.
  3. Once connected, use its UUID in your API requests.

Using connectors in the API

Pass connector UUIDs in the connectors array of the message object when creating a task:
You can pass multiple connectors in a single task:

Available connectors

You can also retrieve available connectors programmatically via connector.list.

Default connectors

When you omit the connectors array from your message, Manus automatically resolves which connectors to use: Priority: explicit param > project default > user default. To set your default connectors, visit the integrations page on manus.im and enable the connectors you want to use by default.

Updating connectors on a running task

When you continue a task with task.sendMessage, connectors resolve differently than at creation time. The message.connectors array combines with the top-level clear_connectors flag to form three states: Passing a non-empty message.connectors together with clear_connectors: true is a conflict and returns InvalidArgument.
This differs from task.create. On a follow-up message, omitting connectors (or passing an empty array []) reuses the task’s existing configuration — it does not re-resolve project or user defaults, and it does not follow later changes to those defaults. To start fresh, pass an explicit list or clear_connectors: true.

Privacy & Security

All connectors use secure OAuth authentication. Your credentials are never shared with Manus directly. You can revoke access at any time from the integrations page on manus.im.