Connect Toolkit

string

required

Toolkit slug, e.g. gmail.

string

Where the user is returned after auth.

curl -X POST https://api.usenaive.ai/v1/users/USER_ID/connections/connect \
  -H "Authorization: Bearer $NAIVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"toolkit":"gmail","callback_url":"https://app.example.com/oauth"}'

Returns { toolkit, connectedAccountId, redirectUrl, status }. Blocked with forbidden if the user’s AccountKit doesn’t allow the toolkit.

May require approval. If the user’s Account Kit gates connections.connect (connections_config.requiresApproval, or per-toolkit approvalToolkits), an agent (API-key) call returns 202 { "status": "pending_approval", "approval_id" } instead of starting the connect flow. A human approves it via Approvals; the connection starts on replay. See Approvals.

curl -X POST https://api.usenaive.ai/v1/users/USER_ID/connections/connect \
  -H "Authorization: Bearer $NAIVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"toolkit":"gmail","callback_url":"https://app.example.com/oauth"}'