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.

Connector selection

message.connectors and the top-level clear_connectors field together decide the task’s connector selection. An empty message.connectors array is treated the same as omitting the field. Passing a non-empty message.connectors together with clear_connectors: true returns InvalidArgument. Connectors not installed in your account return InvalidArgument. For task.create: To change your account defaults, visit the integrations page on manus.im and enable or disable connectors. For task.sendMessage: On a follow-up message, omitting message.connectors does not re-resolve project or account defaults. Passing connectors: [] does not clear the selection; use clear_connectors: true. Clearing the selection only affects connectors. Other task features may still provide tools.

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.