Skip to main content

Documentation Index

Fetch the complete documentation index at: https://agent37.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Connect an agent to Gmail, Slack, Notion, and 1000+ more, every app in the Composio catalog is supported by default. Connections route and meter through Agent37, so there are no integration keys for you to manage. Each connection is scoped to a single instance.

​
Endpoints

ActionEndpoint
Search the catalogGET /v1/instances/{id}/integrations?search=
Start a connectionPOST /v1/instances/{id}/integrations/connect
List connectionsGET /v1/instances/{id}/integrations/connections
DisconnectDELETE /v1/instances/{id}/integrations/connections/{cid}

​
How a connection works

connect returns a redirect_url. Open it for your end user, they authorize the app, and the connection turns active. Connecting is free; the agent using a connected app during a run draws the connected-app meter against your prepaid balance.
1

Start a connection

POST /v1/instances/{id}/integrations/connect with a toolkit. The response carries a connection_id, a redirect_url, and a pending status.
curl -X POST https://api.agent37.com/v1/instances/inst_x7/integrations/connect \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "toolkit": "gmail" }'
2

Send the user to authorize

Open redirect_url for your end user. They sign in to the app and grant access. No keys touch your code.
3

Poll until the connection is active

List the instance’s connections and read the status. When it leaves pending, the agent can use the app on its next run.
curl
curl https://api.agent37.com/v1/instances/inst_x7/integrations/connections \
  -H "Authorization: Bearer sk_live_..."
​
toolkit
string
required
The Composio toolkit to connect, such as gmail, slack, or notion. Search the catalog for the full set of identifiers.
POST /v1/instances/inst_x7/integrations/connect
{ "toolkit": "gmail" }

​
Disconnect

Remove a connection with DELETE /v1/instances/{id}/integrations/connections/{cid}, passing the connection_id as {cid}.
curl
curl -X DELETE \
  https://api.agent37.com/v1/instances/inst_x7/integrations/connections/conn_5a \
  -H "Authorization: Bearer sk_live_..."
Disconnecting revokes the agent’s access to that app on the instance. Any session that relied on the connection loses it immediately.

​
Billing

Connecting is free. Usage draws the connected-app meter against your prepaid balance whenever an agent uses a connected app during a run. Rates live on the pricing page; balance and top-ups are managed in the dashboard.

​
Next steps

Instances

Connections are scoped to one instance.

Send a message

Let the agent use a connected app during a run.

Scheduled runs

Run a connected agent unattended on a cron schedule.

Billing

Prepaid balance and per-meter rates.