Turn on a feature add-on

PUT/v1/api/store/{team_slug}/setting/feature_addon/{module}/enable

v1Operation ID v1_public_setting_feature_addon_enable

Turns on an optional feature. The only add-on is cust_msg_status, "customer message statuses": statuses for message threads, so you can track which conversations need a reply.

When it is turned on and the team has no message thread statuses (deleted ones don't count), YoPrint adds three to the customer_message list: Awaiting Customer Reply (start), Need to Respond and Completed (end). Turning it on again keeps the statuses you have.

This doesn't change your YoPrint bill.

Returns the full settings object, with cust_msg_status: true.

Permission

Needs the Manage Settings permission. The team owner always has it.

Business rules

{module} must be cust_msg_status; anything else returns 404.

Side effects

Creates the three default message statuses when the list is empty.
Team members who have YoPrint open see the setting change at once.

Path parameters

team_slugstringrequired
Your team slug, shown as Team ID next to your API key in Profile.
- Example your-team
modulestringrequired
The add-on. The only one is cust_msg_status, "customer message statuses".
- One of: "cust_msg_status"
- Example cust_msg_status

Request body

This operation takes no request body.

Response

200Successful response.

dataobjectrequired
The team's settings: the saved general settings (the keys "Update general settings" takes, with their defaults), column (list columns), cust_msg_status (the add-on), the three payment webhook addresses, the read-only customer portal sign-in and payment minimum fields below, and the payment gateway values stored for the team, which can include secret keys (sensitive; treat as private). A team that never changed its date formats reads pdf_date_format: "std" and web_date_format: "us", values outside the list the update takes.
Child fields (13)
- columnobject | array
  List columns, by list name (sales_order, quote, ...). An empty array [] when none is saved.
- cust_msg_statusboolean
  Whether the customer message statuses add-on is on.
- customer_portal_account_login_availableboolean
  Read only: whether customers can sign in to your customer portal with an email account. True when your plan includes the customer portal.
- customer_portal_rolloutobject
  Read only: where the customer portal's move to email-account sign-in stands for your team. YoPrint sets the dates; you can't change them here.
  Child fields (6)
  - account_onlybooleanrequired
    True when customers must sign in with an email account: a portal link alone no longer opens the portal.
  - all_teams_atstring (date-time) | nullrequired
    From when every team is account-only (UTC), or null when not set.
  - configuration_warningstring | nullrequired
    Set when YoPrint's own rollout dates are inconsistent; null normally.
    One of: "new_teams_cutoff_not_before_all_teams_cutoff", "invalid_rollout_date"
  - legacy_access_allowedbooleanrequired
    The opposite of account_only: portal links still open the portal.
  - new_teams_atstring (date-time) | nullrequired
    From when new teams are account-only (UTC), or null when not set.
  - reasonstringrequired
    transition: links still work. new_team_cutoff: the team was created after the date for new teams. all_teams_cutoff: the date for every team has passed.
    One of: "transition", "new_team_cutoff", "all_teams_cutoff"
- pagination_per_pageinteger
- payment_amount_policiesmap of objects
  Read only: the same for each of your currencies, deleted ones included, keyed by ISO code (orders keep the currency they were made in). [] when the team has none.
  Fields of each item (3)
  - minimum_paymentdecimal pairrequired
    A decimal pair whose value is a string: the amount is value ÷ 10^dp ({"value": "1000", "dp": 3} is 1.00). YoPrint refuses smaller payments.
    See Money and quantities.
  - currencystringrequired
  - minimum_remaining_balancenullrequired
    Always null here.
- payment_amount_policyobject | null
  Read only: the smallest payment YoPrint takes in your default currency, or null when the team has no default currency.
  Child fields (3)
  - minimum_paymentdecimal pairrequired
    A decimal pair whose value is a string: the amount is value ÷ 10^dp ({"value": "1000", "dp": 3} is 1.00). YoPrint refuses smaller payments.
    See Money and quantities.
  - currencystringrequired
  - minimum_remaining_balancenullrequired
    Always null here.
- paypal_webhook_urlstring (uri)
  The same for PayPal.
- pdf_date_formatstring
  Date format on PDFs. std is the default for a team that never changed it; PDFs show it like other_1 (05 Nov 2026). A team whose saved settings have no date format reads other_1. "Update general settings" accepts only the other five values.
  - One of: "std", "default", "british_standard", "us_standard", "international", "other_1"
- shipping_label_create_cost_line_itemboolean
  Whether "Create Shipping Cost Line Item" starts checked when someone buys a shipping label in the web app. true until changed.
- square_webhook_urlstring (uri)
  The same for Square.
- stripe_webhook_urlstring (uri)
  The address to give Stripe for this team's payment webhooks.
- web_date_formatstring
  Date format in the web app. us is the default for a team that never changed it; the web app shows it like default (Nov 05, 2026). A team whose saved settings have no date format reads default. "Update general settings" accepts only the other five values.
  - One of: "us", "default", "british_standard", "us_standard", "international", "other_1"
statusintegerrequired
successbooleanrequired

Errors

401The API key is missing or wrong (unauthenticated).
403You are not allowed to do this. api_access_not_in_plan: your team's plan doesn't include API access (Pro and above, with an active subscription or trial), so every request answers this until the team upgrades. When your role lacks the permission the operation needs, the body is only {"message": "Insufficient Permission"}. Other refusals use the error envelope, with unauthorized or user_is_not_authorized.
When
Your role lacks Manage Settings. The body is {"message": "Insufficient Permission"}, without the error envelope.
Fix
Use the key of a member whose role has Manage Settings, or the owner's.
404Not found. page_not_found: the team slug is unknown, you are not a member of the team, or an id in the path is not one of this team's. code: null, with a message that starts "No query results for": there is no record with that id.
When
The module is not cust_msg_status: error.code page_not_found, error.message null.
Fix
Use cust_msg_status.

Notes

Treat the response as sensitive: besides your preferences it can carry the payment gateway values stored for the team. Don't log or share it.

PUTTurn off a feature add-on/v1/api/store/{team_slug}/setting/feature_addon/{module}/disable
GETList message thread statuses/v1/api/store/{team_slug}/setting/status/customer_message

Example request

curl

curl -X PUT 'https://secure.yoprint.com/v1/api/store/your-team/setting/feature_addon/cust_msg_status/enable' \  -H 'Authorization: Bearer YOUR_API_KEY' \  -H 'Accept: application/json' \  -H 'X-Yoprint-Decimal-Format: exact-v1'

Example response 200

{
  "data": {
    "column": [],
    "cust_msg_status": true,
    "customer_portal_account_login_available": true,
    "customer_portal_rollout": {
      "account_only": false,
      "all_teams_at": null,
      "configuration_warning": null,
      "legacy_access_allowed": true,
      "new_teams_at": null,
      "reason": "transition"
    },
    "default_pricing_strategy": "job_separately",
    "dimension": "in",
    "enable_stock_management": true,
    "pagination_per_page": 50,
    "payment_amount_policies": {
      "USD": {
        "currency": "USD",
        "minimum_payment": {
          "dp": 3,
          "value": "1000"
        },
        "minimum_remaining_balance": null
      }
    },
    "payment_amount_policy": {
      "currency": "USD",
      "minimum_payment": {
        "dp": 3,
        "value": "1000"
      },
      "minimum_remaining_balance": null
    },
    "paypal_webhook_url": "https://secure.yoprint.com/api/store/your-team/webhook/v1/payment/paypal",
    "pdf_date_format": "us_standard",
    "pdf_sales_order_display_option": [
      "job_summary"
    ],
    "shipping_label_create_cost_line_item": true,
    "square_webhook_url": "https://secure.yoprint.com/api/store/your-team/webhook/v1/payment/square",
    "stripe_webhook_url": "https://secure.yoprint.com/api/store/your-team/webhook/v1/payment/stripe",
    "web_date_format": "default",
    "weight": "lbs"
  },
  "status": 200,
  "success": true
}

AI agents: read /llms.txt; add .md to any page URL for its Markdown. Guides and concepts in one file: /llms-full.txt.

Download the OpenAPI spec Support: support@yoprint.com yoprint.com