The Customer portal configuration object
Attributes
- idstring
Unique identifier for the object.
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- activeboolean
Whether the configuration is active and can be used to create portal sessions.
- applicationnullable stringExpandableConnect only
ID of the Connect Application that created the configuration.
- business_
profileobject The business information shown to customers in the portal.
- createdtimestamp
Time at which the object was created. Measured in seconds since the Unix epoch.
- default_
return_ urlnullable string The default URL to redirect customers to when they click on the portal’s link to return to your website. This can be overriden when creating the session.
- featuresobject
Information about the features available in the portal.
- is_
defaultboolean Whether the configuration is the default. If
true
, this configuration can be managed in the Dashboard and portal sessions will use this configuration unless it is overriden when creating the session. - livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - login_
pageobject The hosted login page for this configuration. Learn more about the portal login page in our integration docs.
- metadatanullable object
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- updatedtimestamp
Time at which the object was last updated. Measured in seconds since the Unix epoch.
Create a portal configuration
Creates a configuration that describes the functionality and behavior of a PortalSession
Parameters
- business_
profileobjectRequired The business information shown to customers in the portal.
- featuresobjectRequired
Information about the features available in the portal.
- default_
return_ urlstring The default URL to redirect customers to when they click on the portal’s link to return to your website. This can be overriden when creating the session.
- login_
pageobject The hosted login page for this configuration. Learn more about the portal login page in our integration docs.
- metadataobject
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata
.
Returns
Returns a portal configuration object.
Update a portal configuration
Updates a configuration that describes the functionality of the customer portal.
Parameters
- activeboolean
Whether the configuration is active and can be used to create portal sessions.
- business_
profileobject The business information shown to customers in the portal.
- default_
return_ urlstring The default URL to redirect customers to when they click on the portal’s link to return to your website. This can be overriden when creating the session.
- featuresobject
Information about the features available in the portal.
- login_
pageobject The hosted login page for this configuration. Learn more about the portal login page in our integration docs.
- metadataobject
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata
.
Returns
Returns a portal configuration object.
Retrieve a portal configuration
Retrieves a configuration that describes the functionality of the customer portal.
Parameters
No parameters.
Returns
Returns a portal configuration object.
List portal configurations
Returns a list of configurations that describe the functionality of the customer portal.
Parameters
- activeboolean
Only return configurations that are active or inactive (e.g., pass
true
to only list active configurations). - is_
defaultboolean Only return the default or non-default configurations (e.g., pass
true
to only list the default configuration).
More parameters
- ending_
beforestring - limitinteger
- starting_
afterstring
Returns
Returns a list of portal configuration objects.