This resource controls all aspects of the Foxy customer portal and /s/customer endpoint. Please see the corresponding Foxy documentation for additional information on what each parameter does.

Sandbox Example

You can interact with this resource and run actions against the sandbox API via our HAL Brower.


View a customer_portal_settings
Update a customer_portal_settings (send only the properties you want to modify)
Replace a customer_portal_settings (send the entire representation)
Delete a customer_portal_settings
Get just the header response
Get a response explaining which HTTP methods are supported


Property Description Type Constraints
sessionLifespanInMinutes Life span of session in minutes. Integer Maximum 40320 (4 weeks)
allowedOrigins An array of domains. No trailing slashes, must be https unless it's localhost. Can accept a port. Array of Strings Allow up to 10 entries.
sso If this field is true we get legacy API key or sso key from store and save it in settings. For false value we drop it. Boolean true or false, 1 or 0.
jwtSharedSecret Shared secret key. Strings More than 40 and less than 100.
subscriptions Object which contains "allowFrequencyModification" and "allowNextDateModification" fields Object Subscription modification data
subscriptions.allowFrequencyModification An array that contains objects with jsonataQuery and values Array Max length 10 (items)
subscriptions.allowFrequencyModification.jsonataQuery A string that should be a valid JSONata( query String max length 200 characters
subscriptions.allowFrequencyModification.values These strings should match the sub_frequency regex sanitization. Array of Strings Max array length 20, max length per string 4 characters.
subscriptions.allowNextDateModification We can forbid modify subscription next date Boolean or Object true or false, 1 or 0 or object
subscriptions.allowNextDateModification.min Beginning of the time period this rule applies to as frequency. Example: 2w – apply to dates at least 2 weeks from now. String max length 50 characters
subscriptions.allowNextDateModification.max End of the time period this rules applies to as frequency. Example: 1y – apply to dates at most 1 year from now. String max length 50 characters
subscriptions.allowNextDateModification.jsonataQuery Subscription selector that should be a valid [JSONata]( query. String max length 200 characters
subscriptions.allowNextDateModification.disallowedDates List of dates (YYYY-MM-DD) that customers can't pick as next payment date.
NOTE: Should accept YYYY-MM-DD..YYYY-MM-DD as a range as well
Array of Strings Max length 10 (items)
subscriptions.allowNextDateModification.allowedDays A pattern defining the days that will be available for customers to pick as the next payment date. Object Days
subscriptions.allowNextDateModification.allowedDays.type Constraint type. If day, then this rule contains days of week only.
If month, then this rule contains days of month only.
String Can be day or month
subscriptions.allowNextDateModification.allowedDays.days Days of week, 1-7, where 1 is Monday and 7 is Sunday or days of month, 1-31. Array of Numbers List of days
date_created The date this resource was created. Date Read only
date_modified The date this resource was last modified. Date Read only

Example Representation

    "_links": {
        "curies": [
                "name": "fx",
                "href": "{rel}",
                "templated": true
        "self": {
            "href": "https://api.foxycart.test/stores/123/customer_portal_settings",
            "title": "Store Customer Portal Settings"
        "fx:store": {
            "href": "https://api.foxycart.test/stores/123",
            "title": "This Store"
    "sessionLifespanInMinutes": 90,
    "allowedOrigins": [
    "subscriptions": {
        "allowFrequencyModification": [
                "jsonataQuery": "$contains(frequency, \"w\")",
                "values": [
        "allowNextDateModification": [
                "allowedDays": {
                    "days": [
                    "type": "day"
                "disallowedDates": [
                "jsonataQuery": "$contains(frequency, \"w\")",
                "max": "1y",
                "min": "2w"
                "allowedDays": {
                    "days": [
                    "type": "month"
                "disallowedDates": [
                "jsonataQuery": "$contains(frequency, \"w\")",
                "max": "2y",
                "min": "1w"
    "jwtSharedSecret": "ac733fbd-76c0-4cde-8a4c-5c1842e4fb9a-df5d119e-eaec-4967-9fc9-1d4414c55adb",
    "sso": true,
    "date_created": "2020-04-13T08:44:09-0700",
    "date_modified": "2020-04-13T08:46:03-0700"



Zoomable Resources

This resource has no linked resources which can be "zoomed" in on, filtered and embedded within this resource.