> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.itspropel.com/llms.txt. > For full documentation content, see https://docs.itspropel.com/llms-full.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itspropel.com/_mcp/server. # Update Settings PATCH https://companies/%7Bcompany_id%7D/config/membership Content-Type: multipart/form-data Reference: https://docs.itspropel.com/propel-biz/03-company/03-company-config/membership/update-settings ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: PropelBiz version: 1.0.0 paths: /companies/%7Bcompany_id%7D/config/membership: patch: operationId: update-settings summary: Update Settings tags: - >- subpackage_03Company.subpackage_03Company/03CompanyConfig.subpackage_03Company/03CompanyConfig/membership parameters: - name: '{{tenant_key_name}}' in: header required: false schema: type: string responses: '200': description: Successful response content: application/json: schema: $ref: >- #/components/schemas/03 Company_03 Company > Config_Membership_Update Settings_Response_200 requestBody: content: multipart/form-data: schema: type: object properties: proration_mode: type: string description: 'Optional: Proration calculation mode - daily|none' notify_on_signup: type: string description: 'Optional: Send notification on new signup - boolean 0|1' cancellation_mode: type: string description: 'Optional: Cancellation mode - immediate|end_of_period' grace_period_days: type: string description: >- Optional: Grace period after expiry in days - integer, min 0, max 365 membership_prefix: type: string description: >- Optional: Membership number prefix - string, max 20 chars - "MEM" notify_on_renewal: type: string description: 'Optional: Send notification on renewal - boolean 0|1' first_billing_mode: type: string description: >- Optional: First billing date mode - signup_date|first_of_month|first_of_next_month allow_portal_signup: type: string description: 'Optional: Allow customer portal signup - boolean 0|1' price_change_policy: type: string description: >- Optional: Price change policy - immediate|next_cycle|grandfathered allow_prorate_refund: type: string description: 'Optional: Allow prorated refunds - boolean 0|1' auto_renewal_enabled: type: string description: 'Optional: Enable auto-renewal - boolean 0|1' renewal_reminder_days: type: string description: >- Optional: Days before renewal to send reminder - integer, min 0, max 365 notify_on_cancellation: type: string description: 'Optional: Send notification on cancellation - boolean 0|1' allow_technician_signup: type: string description: >- Optional: Allow technicians to sign up customers - boolean 0|1 allow_portal_plan_change: type: string description: 'Optional: Allow customer portal plan change - boolean 0|1' membership_number_format: type: string description: 'Optional: Number format template - string, max 100 chars' notify_on_expiry_warning: type: string description: 'Optional: Send notification on expiry warning - boolean 0|1' price_change_notice_days: type: string description: >- Optional: Days notice before price change - integer, min 0, max 365 allow_portal_cancellation: type: string description: 'Optional: Allow customer portal cancellation - boolean 0|1' suspend_after_failed_days: type: string description: >- Optional: Days after failed payment to auto-suspend - integer, min 0, max 365 required: - proration_mode - notify_on_signup - cancellation_mode - grace_period_days - membership_prefix - notify_on_renewal - first_billing_mode - allow_portal_signup - price_change_policy - allow_prorate_refund - auto_renewal_enabled - renewal_reminder_days - notify_on_cancellation - allow_technician_signup - allow_portal_plan_change - membership_number_format - notify_on_expiry_warning - price_change_notice_days - allow_portal_cancellation - suspend_after_failed_days servers: - url: https:/ components: schemas: 03 Company_03 Company > Config_Membership_Update Settings_Response_200: type: object properties: {} description: Empty response body title: 03 Company_03 Company > Config_Membership_Update Settings_Response_200 ``` ## SDK Code Examples ```python import requests url = "https://https/companies/%7Bcompany_id%7D/config/membership" payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"proration_mode\"\r\n\r\ndaily\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_signup\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"cancellation_mode\"\r\n\r\nend_of_period\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"grace_period_days\"\r\n\r\n14\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"membership_prefix\"\r\n\r\nMEM\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_renewal\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_billing_mode\"\r\n\r\nfirst_of_next_month\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_signup\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"price_change_policy\"\r\n\r\nnext_cycle\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_prorate_refund\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_renewal_enabled\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"renewal_reminder_days\"\r\n\r\n7\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_cancellation\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_technician_signup\"\r\n\r\n0\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_plan_change\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"membership_number_format\"\r\n\r\nMEM-{YYYY}-{0000}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_expiry_warning\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"price_change_notice_days\"\r\n\r\n30\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_cancellation\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"suspend_after_failed_days\"\r\n\r\n10\r\n-----011000010111000001101001--\r\n" headers = { "{{tenant_key_name}}": "{{tenant_key_value1}}|{{tenant_key_value2}}", "Content-Type": "multipart/form-data; boundary=---011000010111000001101001" } response = requests.patch(url, data=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://https/companies/%7Bcompany_id%7D/config/membership'; const form = new FormData(); form.append('proration_mode', 'daily'); form.append('notify_on_signup', '1'); form.append('cancellation_mode', 'end_of_period'); form.append('grace_period_days', '14'); form.append('membership_prefix', 'MEM'); form.append('notify_on_renewal', '1'); form.append('first_billing_mode', 'first_of_next_month'); form.append('allow_portal_signup', '1'); form.append('price_change_policy', 'next_cycle'); form.append('allow_prorate_refund', '1'); form.append('auto_renewal_enabled', '1'); form.append('renewal_reminder_days', '7'); form.append('notify_on_cancellation', '1'); form.append('allow_technician_signup', '0'); form.append('allow_portal_plan_change', '1'); form.append('membership_number_format', 'MEM-{YYYY}-{0000}'); form.append('notify_on_expiry_warning', '1'); form.append('price_change_notice_days', '30'); form.append('allow_portal_cancellation', '1'); form.append('suspend_after_failed_days', '10'); const options = { method: 'PATCH', headers: {'{{tenant_key_name}}': '{{tenant_key_value1}}|{{tenant_key_value2}}'} }; options.body = form; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://https/companies/%7Bcompany_id%7D/config/membership" payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"proration_mode\"\r\n\r\ndaily\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_signup\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"cancellation_mode\"\r\n\r\nend_of_period\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"grace_period_days\"\r\n\r\n14\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"membership_prefix\"\r\n\r\nMEM\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_renewal\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_billing_mode\"\r\n\r\nfirst_of_next_month\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_signup\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"price_change_policy\"\r\n\r\nnext_cycle\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_prorate_refund\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_renewal_enabled\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"renewal_reminder_days\"\r\n\r\n7\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_cancellation\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_technician_signup\"\r\n\r\n0\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_plan_change\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"membership_number_format\"\r\n\r\nMEM-{YYYY}-{0000}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_expiry_warning\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"price_change_notice_days\"\r\n\r\n30\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_cancellation\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"suspend_after_failed_days\"\r\n\r\n10\r\n-----011000010111000001101001--\r\n") req, _ := http.NewRequest("PATCH", url, payload) req.Header.Add("{{tenant_key_name}}", "{{tenant_key_value1}}|{{tenant_key_value2}}") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://https/companies/%7Bcompany_id%7D/config/membership") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Patch.new(url) request["{{tenant_key_name}}"] = '{{tenant_key_value1}}|{{tenant_key_value2}}' request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"proration_mode\"\r\n\r\ndaily\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_signup\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"cancellation_mode\"\r\n\r\nend_of_period\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"grace_period_days\"\r\n\r\n14\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"membership_prefix\"\r\n\r\nMEM\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_renewal\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_billing_mode\"\r\n\r\nfirst_of_next_month\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_signup\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"price_change_policy\"\r\n\r\nnext_cycle\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_prorate_refund\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_renewal_enabled\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"renewal_reminder_days\"\r\n\r\n7\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_cancellation\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_technician_signup\"\r\n\r\n0\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_plan_change\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"membership_number_format\"\r\n\r\nMEM-{YYYY}-{0000}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_expiry_warning\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"price_change_notice_days\"\r\n\r\n30\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_cancellation\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"suspend_after_failed_days\"\r\n\r\n10\r\n-----011000010111000001101001--\r\n" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.patch("https://https/companies/%7Bcompany_id%7D/config/membership") .header("{{tenant_key_name}}", "{{tenant_key_value1}}|{{tenant_key_value2}}") .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"proration_mode\"\r\n\r\ndaily\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_signup\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"cancellation_mode\"\r\n\r\nend_of_period\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"grace_period_days\"\r\n\r\n14\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"membership_prefix\"\r\n\r\nMEM\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_renewal\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_billing_mode\"\r\n\r\nfirst_of_next_month\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_signup\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"price_change_policy\"\r\n\r\nnext_cycle\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_prorate_refund\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_renewal_enabled\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"renewal_reminder_days\"\r\n\r\n7\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_cancellation\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_technician_signup\"\r\n\r\n0\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_plan_change\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"membership_number_format\"\r\n\r\nMEM-{YYYY}-{0000}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_expiry_warning\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"price_change_notice_days\"\r\n\r\n30\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_cancellation\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"suspend_after_failed_days\"\r\n\r\n10\r\n-----011000010111000001101001--\r\n") .asString(); ``` ```php request('PATCH', 'https://https/companies/%7Bcompany_id%7D/config/membership', [ 'multipart' => [ [ 'name' => 'proration_mode', 'contents' => 'daily' ], [ 'name' => 'notify_on_signup', 'contents' => '1' ], [ 'name' => 'cancellation_mode', 'contents' => 'end_of_period' ], [ 'name' => 'grace_period_days', 'contents' => '14' ], [ 'name' => 'membership_prefix', 'contents' => 'MEM' ], [ 'name' => 'notify_on_renewal', 'contents' => '1' ], [ 'name' => 'first_billing_mode', 'contents' => 'first_of_next_month' ], [ 'name' => 'allow_portal_signup', 'contents' => '1' ], [ 'name' => 'price_change_policy', 'contents' => 'next_cycle' ], [ 'name' => 'allow_prorate_refund', 'contents' => '1' ], [ 'name' => 'auto_renewal_enabled', 'contents' => '1' ], [ 'name' => 'renewal_reminder_days', 'contents' => '7' ], [ 'name' => 'notify_on_cancellation', 'contents' => '1' ], [ 'name' => 'allow_technician_signup', 'contents' => '0' ], [ 'name' => 'allow_portal_plan_change', 'contents' => '1' ], [ 'name' => 'membership_number_format', 'contents' => 'MEM-{YYYY}-{0000}' ], [ 'name' => 'notify_on_expiry_warning', 'contents' => '1' ], [ 'name' => 'price_change_notice_days', 'contents' => '30' ], [ 'name' => 'allow_portal_cancellation', 'contents' => '1' ], [ 'name' => 'suspend_after_failed_days', 'contents' => '10' ] ] 'headers' => [ '{{tenant_key_name}}' => '{{tenant_key_value1}}|{{tenant_key_value2}}', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://https/companies/%7Bcompany_id%7D/config/membership"); var request = new RestRequest(Method.PATCH); request.AddHeader("{{tenant_key_name}}", "{{tenant_key_value1}}|{{tenant_key_value2}}"); request.AddParameter("undefined", "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"proration_mode\"\r\n\r\ndaily\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_signup\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"cancellation_mode\"\r\n\r\nend_of_period\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"grace_period_days\"\r\n\r\n14\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"membership_prefix\"\r\n\r\nMEM\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_renewal\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_billing_mode\"\r\n\r\nfirst_of_next_month\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_signup\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"price_change_policy\"\r\n\r\nnext_cycle\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_prorate_refund\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"auto_renewal_enabled\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"renewal_reminder_days\"\r\n\r\n7\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_cancellation\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_technician_signup\"\r\n\r\n0\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_plan_change\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"membership_number_format\"\r\n\r\nMEM-{YYYY}-{0000}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"notify_on_expiry_warning\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"price_change_notice_days\"\r\n\r\n30\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"allow_portal_cancellation\"\r\n\r\n1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"suspend_after_failed_days\"\r\n\r\n10\r\n-----011000010111000001101001--\r\n", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["{{tenant_key_name}}": "{{tenant_key_value1}}|{{tenant_key_value2}}"] let parameters = [ [ "name": "proration_mode", "value": "daily" ], [ "name": "notify_on_signup", "value": "1" ], [ "name": "cancellation_mode", "value": "end_of_period" ], [ "name": "grace_period_days", "value": "14" ], [ "name": "membership_prefix", "value": "MEM" ], [ "name": "notify_on_renewal", "value": "1" ], [ "name": "first_billing_mode", "value": "first_of_next_month" ], [ "name": "allow_portal_signup", "value": "1" ], [ "name": "price_change_policy", "value": "next_cycle" ], [ "name": "allow_prorate_refund", "value": "1" ], [ "name": "auto_renewal_enabled", "value": "1" ], [ "name": "renewal_reminder_days", "value": "7" ], [ "name": "notify_on_cancellation", "value": "1" ], [ "name": "allow_technician_signup", "value": "0" ], [ "name": "allow_portal_plan_change", "value": "1" ], [ "name": "membership_number_format", "value": "MEM-{YYYY}-{0000}" ], [ "name": "notify_on_expiry_warning", "value": "1" ], [ "name": "price_change_notice_days", "value": "30" ], [ "name": "allow_portal_cancellation", "value": "1" ], [ "name": "suspend_after_failed_days", "value": "10" ] ] let boundary = "---011000010111000001101001" var body = "" var error: NSError? = nil for param in parameters { let paramName = param["name"]! body += "--\(boundary)\r\n" body += "Content-Disposition:form-data; name=\"\(paramName)\"" if let filename = param["fileName"] { let contentType = param["content-type"]! let fileContent = String(contentsOfFile: filename, encoding: String.Encoding.utf8) if (error != nil) { print(error as Any) } body += "; filename=\"\(filename)\"\r\n" body += "Content-Type: \(contentType)\r\n\r\n" body += fileContent } else if let paramValue = param["value"] { body += "\r\n\r\n\(paramValue)" } } let request = NSMutableURLRequest(url: NSURL(string: "https://https/companies/%7Bcompany_id%7D/config/membership")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PATCH" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```