Tools
connections_create
Begin connecting a new social account: returns a provider consent `url` for the HUMAN to open in a browser, plus a `connect_id` to poll with connections_get.
Begin connecting a new social account: returns a provider consent url for the HUMAN to open in a browser, plus a connect_id to poll with connections_get. The URL expires in ~10 minutes.
Input
| Field | Type | Required | Description |
|---|---|---|---|
organization | string | no | Organization slug to act in (see organizations_list). Optional: API keys are bound to one organization; OAuth connections default to your active organization. |
provider | "fake" | "linkedin" | "mastodon" | "x" | "instagram" | "facebook" | "threads" | "bluesky" | "tiktok" | "youtube" | yes | Provider to connect |
Result
JSON on success. A refusal comes back as an error prefixed with its code (NOT_FOUND, FORBIDDEN, TOO_MANY_REQUESTS, …) and a message written to be acted on — read it before retrying.
The same operation elsewhere
This tool and the REST operation connectionsCreate run the same guarded procedure the dashboard uses — same permissions, same validation, same tenant isolation.