| Field | Type | Required | Description | Example |
|---|---|---|---|---|
subscriberId |
?string | ➖ | The subscriber ID to associate with the channel connection. For Slack: optional for workspace connections (required only for incoming-webhook scope). For MS Teams: optional. Admin consent is tenant-wide. | subscriber-123 |
integrationIdentifier |
string | ✔️ | Integration identifier | |
connectionIdentifier |
?string | ➖ | Identifier of the channel connection that will be created. Generated automatically if not provided. | slack-connection-abc123 |
context |
array<string, string|Components\GenerateConnectOauthUrlRequestDtoContext2> | ➖ | N/A | |
scope |
array<string> | ➖ | Slack only: OAuth scopes to request during authorization. If not specified, default scopes will be used: chat:write, chat:write.public, channels:read, groups:read, users:read, users:read.email. MS Teams: ignored — uses admin consent with pre-configured Azure AD permissions. | [ "chat:write", "chat:write.public", "channels:read" ] |
connectionMode |
?Components\GenerateConnectOauthUrlRequestDtoConnectionMode | ➖ | Connection mode that determines how the channel connection is scoped. "subscriber" (default) associates the connection with a specific subscriber. "shared" associates the connection with a context instead of a subscriber. | shared |
autoLinkUser |
?bool | ➖ | When true (default when connectionMode is "subscriber"), after the workspace/tenant connection is created the OAuth flow also links the subscriber who clicked "Connect" as a personal endpoint. For Slack, uses the authed_user.id returned by oauth.v2.access — no extra redirect. For MS Teams, triggers a second OAuth redirect for delegated user-identity consent. Set to false to only create the workspace connection without linking the individual user. | true |