Create a connect session

Starts an OAuth flow for one profile and returns the URL to redirect your customer to. Equivalent to start_connect for most agents.

Category: Accounts
Calls: POST/v1/connect/sessions
Safe to auto-approve: No. It changes data, so keep a human in the loop or scope the key.

Parameters

platformenumrequired

Platform to connect.

One of:facebookinstagramtiktoklinkedinyoutube

redirectUrlstringoptional

HTTPS URL to return the user to once they finish or cancel.

profileIdstringoptional

Profile to act on. Omit to use the profile this API key belongs to. Call list_profiles first when managing several customers.

A tool call as an MCP client would send it.

{
  "name": "create_connect_session",
  "arguments": {
    "platform": "facebook"
  }
}