Create connect session - Veryfront

createConnectSession(projectReference: ID!, name: String!, input: CreateConnectSessionInput!): ConnectSession!

Arguments

Argument	Type	Required	Description
`projectReference`	`ID!`	Yes	Project ID or slug. A missing or inaccessible project, including a denied scope-dependent project access check, returns not_found.
`name`	`String!`	Yes	Integration name, for example github.
`input`	`CreateConnectSessionInput!`	Yes

Input fields

input

CreateConnectSessionInput

Field	Type	Required	Description
`scope`	`ConnectionScope!`	Yes	Connection owner. Project scope needs the editor role; user scope connects your own account and needs viewer access to the project. API keys also need the integrations write scope. Verified user-session or API-key credentials are required; MCP OAuth grants and runtime credentials are refused.
`redirectUri`	`String!`	Yes	Trusted web or native URI the browser returns to after consent.

Response

Returns ConnectSession!. Open the type for its fields and nested types.

Field	Type	Description
`sessionToken`	`String!`	One-time connect session token, embedded in connectUrl.
`connectUrl`	`String!`	URL to open in a browser; it starts provider consent through GET /oauth/connect/{integration}.
`expiresAt`	`DateTime!`	Time after which connectUrl no longer starts consent.

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

mutation CreateConnectSession($projectReference: ID!, $name: String!, $input: CreateConnectSessionInput!) {
  createConnectSession(projectReference: $projectReference, name: $name, input: $input) {
    connectUrl
    expiresAt
    sessionToken
  }
}

{
  "projectReference": "00000000-0000-4000-8000-000000000001",
  "name": "github",
  "input": {
    "scope": "user",
    "redirectUri": "veryfront://auth/integrations"
  }
}