Setup
Before using a connector via the API, authorize it in the Manus web app:- Go to your integrations page on manus.im.
- Click the connector you want to add and complete the OAuth flow.
- Once connected, use its UUID in your API requests.
Using connectors in the API
Pass connector UUIDs in theconnectors array of the message object when creating a task:
- cURL
- Python
Available connectors
You can also retrieve available connectors programmatically via connector.list.Default connectors
When you omit theconnectors 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. Themessage.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.