Skip to main content
POST
/
v1
/
users
/
{user_id}
/
connections
/
connect
Connect a toolkit
curl --request POST \
  --url https://api.usenaive.ai/v1/users/{user_id}/connections/connect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "toolkit": "gmail",
  "callback_url": "<string>"
}
'
{
  "toolkit": "<string>",
  "connectedAccountId": "<string>",
  "redirectUrl": "<string>",
  "status": "<string>"
}

Authorizations

​
Authorization
string
header
required

Workspace API key. Create one via the dashboard or POST /v1/auth/keys.

Path Parameters

​
user_id
string
required

Tenant user UUID, or default / me for the operator's default user.

Body

application/json
​
toolkit
string
required
Example:

"gmail"

​
callback_url
string

Response

Connect flow started.

​
toolkit
string
​
connectedAccountId
string
​
redirectUrl
string | null
​
status
string