DataIntegrationsGetDataIntegrationAuthorizeUrlRequest
in package
implements
JsonSerializable
uses
JsonSerializableTrait
Table of Contents
Interfaces
- JsonSerializable
Properties
- $accountDisplayName : string|null
- A mutable, non-unique label. Omit to preserve an existing label; null clears it. Labels are never account identifiers.
- $codeChallenge : string|null
- A PKCE-style code challenge: the base64url-encoded SHA-256 of a `code_verifier` your app keeps. When set, the connection isn't saved when the user finishes authorizing. Instead, the user is redirected to `return_to` with a `connect_code` and `state`, and your app must call [Finish connection](https://workos.com/docs/reference/pipes/connected-account/finish-connection) with the `connect_code` and `code_verifier` within 90 seconds to save it.
- $codeChallengeMethod : string|null
- The method used to derive `code_challenge`. Only `S256` is supported, and it is the default. Requires `code_challenge`.
- $config : array<string, string>|null
- Connect-time config values for the provider-declared `installation`-scope fields (e.g. a Zendesk `subdomain`), keyed by the config field. Only fields the provider declares may be supplied, and required fields must be provided unless already pinned on the integration.
- $connectedAccountId : string|null
- The exact connected account to reauthorize. Required with `connection_intent: reauthorize` and not accepted otherwise.
- $connectionIntent : DataIntegrationsGetDataIntegrationAuthorizeUrlRequestConnectionIntent|null
- Which connection the request targets. Omit it to use the compatibility connection. Send `add` to create another connection: the first connection for an owner shape fills the compatibility slot, and later connections are standard. Send `reauthorize` with `connected_account_id` to reauthorize one exact connection.
- $connectionOwner : PipesOwnership|null
- Who will own the connected account. `user` (the default) connects the user's own account. `organization` connects the organization's shared account and requires `organization_id`.
- $organizationId : string|null
- An organization ID to scope the authorization to a specific organization. Required when `connection_owner` is `organization`.
- $returnTo : string|null
- The URL to redirect the user to after authorization. Required with `code_challenge`, and must then exactly match a redirect URI registered on one of the environment's applications. Loopback URLs match on any port; wildcard redirect URIs are not honored, and a `return_to` with a query string or fragment never matches.
- $userId : string
- The ID of the user to authorize. When `connection_owner` is `organization`, this is the user authorizing on behalf of the organization; they must be an active member of the organization and do not become the owner of the resulting connected account.
Methods
- __construct() : mixed
- fromArray() : self
- jsonSerialize() : array<string|int, mixed>|stdClass
- toArray() : array<string|int, mixed>
Properties
$accountDisplayName
A mutable, non-unique label. Omit to preserve an existing label; null clears it. Labels are never account identifiers.
public
string|null
$accountDisplayName
= null
$codeChallenge
A PKCE-style code challenge: the base64url-encoded SHA-256 of a `code_verifier` your app keeps. When set, the connection isn't saved when the user finishes authorizing. Instead, the user is redirected to `return_to` with a `connect_code` and `state`, and your app must call [Finish connection](https://workos.com/docs/reference/pipes/connected-account/finish-connection) with the `connect_code` and `code_verifier` within 90 seconds to save it.
public
string|null
$codeChallenge
= null
$codeChallengeMethod
The method used to derive `code_challenge`. Only `S256` is supported, and it is the default. Requires `code_challenge`.
public
string|null
$codeChallengeMethod
= null
$config
Connect-time config values for the provider-declared `installation`-scope fields (e.g. a Zendesk `subdomain`), keyed by the config field. Only fields the provider declares may be supplied, and required fields must be provided unless already pinned on the integration.
public
array<string, string>|null
$config
= null
$connectedAccountId
The exact connected account to reauthorize. Required with `connection_intent: reauthorize` and not accepted otherwise.
public
string|null
$connectedAccountId
= null
$connectionIntent
Which connection the request targets. Omit it to use the compatibility connection. Send `add` to create another connection: the first connection for an owner shape fills the compatibility slot, and later connections are standard. Send `reauthorize` with `connected_account_id` to reauthorize one exact connection.
public
DataIntegrationsGetDataIntegrationAuthorizeUrlRequestConnectionIntent|null
$connectionIntent
= null
$connectionOwner
Who will own the connected account. `user` (the default) connects the user's own account. `organization` connects the organization's shared account and requires `organization_id`.
public
PipesOwnership|null
$connectionOwner
= null
$organizationId
An organization ID to scope the authorization to a specific organization. Required when `connection_owner` is `organization`.
public
string|null
$organizationId
= null
$returnTo
The URL to redirect the user to after authorization. Required with `code_challenge`, and must then exactly match a redirect URI registered on one of the environment's applications. Loopback URLs match on any port; wildcard redirect URIs are not honored, and a `return_to` with a query string or fragment never matches.
public
string|null
$returnTo
= null
$userId
The ID of the user to authorize. When `connection_owner` is `organization`, this is the user authorizing on behalf of the organization; they must be an active member of the organization and do not become the owner of the resulting connected account.
public
string
$userId
Methods
__construct()
public
__construct(string $userId[, string|null $accountDisplayName = null ][, string|null $organizationId = null ][, PipesOwnership|null $connectionOwner = null ][, string|null $returnTo = null ][, string|null $codeChallenge = null ][, string|null $codeChallengeMethod = null ][, array<string|int, mixed>|null $config = null ][, DataIntegrationsGetDataIntegrationAuthorizeUrlRequestConnectionIntent|null $connectionIntent = null ][, string|null $connectedAccountId = null ]) : mixed
Parameters
- $userId : string
- $accountDisplayName : string|null = null
- $organizationId : string|null = null
- $connectionOwner : PipesOwnership|null = null
- $returnTo : string|null = null
- $codeChallenge : string|null = null
- $codeChallengeMethod : string|null = null
- $config : array<string|int, mixed>|null = null
- $connectionIntent : DataIntegrationsGetDataIntegrationAuthorizeUrlRequestConnectionIntent|null = null
- $connectedAccountId : string|null = null
fromArray()
public
static fromArray(array<string|int, mixed> $data) : self
Parameters
- $data : array<string|int, mixed>
Return values
selfjsonSerialize()
public
jsonSerialize() : array<string|int, mixed>|stdClass
Return values
array<string|int, mixed>|stdClasstoArray()
public
toArray() : array<string|int, mixed>