> ## Documentation Index > Fetch the complete documentation index at: https://docs.getruba.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Product > ### Intent Creates a product from the values supplied in the request. ### When to call it Call this when your application has collected the required values and is ready to create a product. ### Access boundary Authorize the request with a token that carries `products:write`. ### Successful result A successful request returns `201`. The response schema below defines the body your integration receives. export const RubaSocials = () => { if (typeof document === "undefined") { return null; } const inject = () => { const footer = document.getElementById("footer"); if (!footer || document.getElementById("ruba-socials")) { return false; } const isDark = document.querySelector("html.dark") || document.querySelector('html[class*="dark"]'); const lineColor = isDark ? "#383838" : "#e8e8ed"; const iconColor = isDark ? "#8e8e93" : "#86868b"; const markColor = isDark ? "#ffffff" : "#08080c"; const hoverColor = "#0071e3"; const div = document.createElement("div"); div.id = "ruba-socials"; div.style.cssText = `display:flex;align-items:center;gap:20px;padding-top:20px;margin-top:20px;border-top:1px solid ${lineColor};width:100%`; const logo = `Ruba`; const spacer = `
`; const ig = ``; const li = ``; const x = ``; const github = ``; div.innerHTML = logo + spacer + ig + li + x + github; footer.appendChild(div); return true; }; if (!document.documentElement.dataset.rubaSocialsObserver) { document.documentElement.dataset.rubaSocialsObserver = "true"; const observer = new MutationObserver(() => { if (!document.getElementById("ruba-socials")) { inject(); } }); observer.observe(document.body, { childList: true, subtree: true }); } setTimeout(() => { if (!inject()) { const interval = setInterval(() => { if (inject()) { clearInterval(interval); } }, 500); setTimeout(() => clearInterval(interval), 10000); } }, 300); return null; }; ## OpenAPI ````yaml post /v1/products/ openapi: 3.1.0 info: title: Ruba API summary: Ruba HTTP and Webhooks API description: '**Details:** Read the docs at https://docs.getruba.com/api-reference.' version: 2026-04 servers: - url: https://api.getruba.com description: '**Details:** Production environment.' x-speakeasy-server-id: production - url: https://sandbox-api.getruba.com description: '**Details:** Sandbox environment.' x-speakeasy-server-id: sandbox security: [] tags: - name: public description: >- **Details:** Endpoints shown and documented in the Ruba API documentation and available in our SDKs. - name: private description: >- **Details:** Endpoints that should appear in the schema only in development to generate our internal JS SDK. paths: /v1/products/: post: tags: - products - public summary: Create Product description: >- ### Intent Creates a product from the values supplied in the request. ### When to call it Call this when your application has collected the required values and is ready to create a product. ### Access boundary Authorize the request with a token that carries `products:write`. ### Successful result A successful request returns `201`. The response schema below defines the body your integration receives. operationId: products:create requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProductCreate' responses: '201': description: '**Response:** Product created.' content: application/json: schema: $ref: '#/components/schemas/Product' '422': description: Request validation failed content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - oidc: - products:write - pat: - products:write - oat: - products:write components: schemas: ProductCreate: oneOf: - $ref: '#/components/schemas/ProductCreateRecurring' - $ref: '#/components/schemas/ProductCreateOneTime' Product: properties: id: type: string format: uuid4 title: Id description: The stable identifier for this record. created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. trial_interval: anyOf: - $ref: '#/components/schemas/TrialInterval' - type: 'null' description: Unit used to measure the trial period. trial_interval_count: anyOf: - type: integer - type: 'null' title: Trial Interval Count description: Length of the trial measured in the selected interval. name: type: string title: Name description: Customer-facing name assigned to the product. description: anyOf: - type: string - type: 'null' title: Description description: Customer-facing description attached to the product. visibility: $ref: '#/components/schemas/ProductVisibility' description: Controls where customers can discover the product. recurring_interval: anyOf: - $ref: '#/components/schemas/RecurringInterval' - type: 'null' description: >- **Recurring Interval:** Recurring interval of the product. If `None`, the product is a one-time purchase. recurring_interval_count: anyOf: - type: integer - type: 'null' title: Recurring Interval Count description: >- Count of interval units of the subscription. If this is set to 1 the charge will happen every interval (e.g. every month), if set to 2 it will be every other month, and so on. None for one-time products. is_recurring: type: boolean title: Is Recurring description: Indicates whether the product is a subscription. is_archived: type: boolean title: Is Archived description: Indicates whether the product is archived and no longer available. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the product. metadata: $ref: '#/components/schemas/MetadataOutputType' prices: items: oneOf: - $ref: '#/components/schemas/LegacyRecurringProductPrice' - $ref: '#/components/schemas/ProductPrice' type: array title: Prices description: Collection of prices for this product. benefits: items: $ref: '#/components/schemas/Benefit' title: Benefit type: array title: Benefits description: Collection of benefits granted by the product. medias: items: $ref: '#/components/schemas/ProductMediaFileRead' type: array title: Medias description: Collection of medias associated to the product. attached_custom_fields: items: $ref: '#/components/schemas/AttachedCustomField' type: array title: Attached Custom Fields description: Collection of custom fields attached to the product. type: object required: - id - created_at - modified_at - trial_interval - trial_interval_count - name - description - visibility - recurring_interval - recurring_interval_count - is_recurring - is_archived - organization_id - metadata - prices - benefits - medias - attached_custom_fields title: Product description: Object representing product. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ProductCreateRecurring: properties: metadata: additionalProperties: anyOf: - type: string maxLength: 500 minLength: 1 - type: integer - type: number - type: boolean propertyNames: maxLength: 40 minLength: 1 type: object maxProperties: 50 title: Metadata description: |- Metadata map for information your integration needs to retain. The key must be a string with a maximum length of **40 characters**. The value must be either: * A string with a maximum length of **500 characters** * An integer * A floating-point number * A boolean You can store up to **50 key-value pairs**. name: type: string maxLength: 64 minLength: 3 title: Name description: Customer-facing name assigned to the product. description: anyOf: - type: string - type: 'null' title: Description description: Customer-facing description attached to the product. visibility: $ref: '#/components/schemas/ProductVisibility' description: Controls where customers can discover the product. default: public prices: items: oneOf: - $ref: '#/components/schemas/ProductPriceFixedCreate' - $ref: '#/components/schemas/ProductPriceCustomCreate' - $ref: '#/components/schemas/ProductPriceSeatBasedCreate' - $ref: '#/components/schemas/ProductPriceMeteredUnitCreate' discriminator: propertyName: amount_type mapping: custom: $ref: '#/components/schemas/ProductPriceCustomCreate' fixed: $ref: '#/components/schemas/ProductPriceFixedCreate' metered_unit: $ref: '#/components/schemas/ProductPriceMeteredUnitCreate' seat_based: $ref: '#/components/schemas/ProductPriceSeatBasedCreate' type: array minItems: 1 title: ProductPriceCreateList description: >- Collection of available prices for this product. It may combine at most one fixed price with one seat-based price (billed as `fixed + seat_charge`), or contain a single custom or free price, plus any number of metered prices. A free price cannot be combined with other prices, and a custom price cannot be combined with a fixed or seat-based price. Metered prices are not supported on one-time purchase products. medias: anyOf: - items: type: string format: uuid4 type: array - type: 'null' title: Medias description: >- Collection of file IDs. Each one must be on the same organization as the product, of type `product_media` and correctly uploaded. attached_custom_fields: items: $ref: '#/components/schemas/AttachedCustomFieldCreate' type: array title: Attached Custom Fields description: Collection of custom fields to attach. organization_id: anyOf: - type: string format: uuid4 description: Identifier of the organization. examples: - 1dbfc517-0bbf-4301-9ba8-555ca42b9737 x-ruba-selector-widget: displayProperty: name resourceName: Organization resourceRoot: /v1/organizations - type: 'null' title: Organization Id description: >- Identifier of the organization owning the product. **Required unless you use an organization token.**. trial_interval: anyOf: - $ref: '#/components/schemas/TrialInterval' - type: 'null' description: Unit used to measure the trial period. trial_interval_count: anyOf: - type: integer maximum: 1000 minimum: 1 - type: 'null' title: Trial Interval Count description: Length of the trial measured in the selected interval. recurring_interval: $ref: '#/components/schemas/RecurringInterval' description: '**Recurring Interval:** Recurring interval of the product.' recurring_interval_count: type: integer maximum: 999 minimum: 1 title: Recurring Interval Count description: >- Count of interval units of the subscription. If this is set to 1 the charge will happen every interval (e.g. every month), if set to 2 it will be every other month, and so on. default: 1 type: object required: - name - prices - recurring_interval title: ProductCreateRecurring ProductCreateOneTime: properties: metadata: additionalProperties: anyOf: - type: string maxLength: 500 minLength: 1 - type: integer - type: number - type: boolean propertyNames: maxLength: 40 minLength: 1 type: object maxProperties: 50 title: Metadata description: |- Metadata map for information your integration needs to retain. The key must be a string with a maximum length of **40 characters**. The value must be either: * A string with a maximum length of **500 characters** * An integer * A floating-point number * A boolean You can store up to **50 key-value pairs**. name: type: string maxLength: 64 minLength: 3 title: Name description: Customer-facing name assigned to the product. description: anyOf: - type: string - type: 'null' title: Description description: Customer-facing description attached to the product. visibility: $ref: '#/components/schemas/ProductVisibility' description: Controls where customers can discover the product. default: public prices: items: oneOf: - $ref: '#/components/schemas/ProductPriceFixedCreate' - $ref: '#/components/schemas/ProductPriceCustomCreate' - $ref: '#/components/schemas/ProductPriceSeatBasedCreate' - $ref: '#/components/schemas/ProductPriceMeteredUnitCreate' discriminator: propertyName: amount_type mapping: custom: $ref: '#/components/schemas/ProductPriceCustomCreate' fixed: $ref: '#/components/schemas/ProductPriceFixedCreate' metered_unit: $ref: '#/components/schemas/ProductPriceMeteredUnitCreate' seat_based: $ref: '#/components/schemas/ProductPriceSeatBasedCreate' type: array minItems: 1 title: ProductPriceCreateList description: >- Collection of available prices for this product. It may combine at most one fixed price with one seat-based price (billed as `fixed + seat_charge`), or contain a single custom or free price, plus any number of metered prices. A free price cannot be combined with other prices, and a custom price cannot be combined with a fixed or seat-based price. Metered prices are not supported on one-time purchase products. medias: anyOf: - items: type: string format: uuid4 type: array - type: 'null' title: Medias description: >- Collection of file IDs. Each one must be on the same organization as the product, of type `product_media` and correctly uploaded. attached_custom_fields: items: $ref: '#/components/schemas/AttachedCustomFieldCreate' type: array title: Attached Custom Fields description: Collection of custom fields to attach. organization_id: anyOf: - type: string format: uuid4 description: Identifier of the organization. examples: - 1dbfc517-0bbf-4301-9ba8-555ca42b9737 x-ruba-selector-widget: displayProperty: name resourceName: Organization resourceRoot: /v1/organizations - type: 'null' title: Organization Id description: >- Identifier of the organization owning the product. **Required unless you use an organization token.**. recurring_interval: type: 'null' title: Recurring Interval description: >- **Recurring Interval:** States that the product is a one-time purchase. recurring_interval_count: type: 'null' title: Recurring Interval Count description: >- **Recurring Interval Count:** One-time products don't have a recurring interval count. type: object required: - name - prices title: ProductCreateOneTime TrialInterval: type: string enum: - day - week - month - year title: TrialInterval ProductVisibility: type: string enum: - draft - private - public title: Visibility RecurringInterval: type: string enum: - day - week - month - year title: RecurringInterval MetadataOutputType: additionalProperties: anyOf: - type: string - type: integer - type: number - type: boolean type: object LegacyRecurringProductPrice: oneOf: - $ref: '#/components/schemas/LegacyRecurringProductPriceFixed' - $ref: '#/components/schemas/LegacyRecurringProductPriceCustom' discriminator: propertyName: amount_type mapping: custom: $ref: '#/components/schemas/LegacyRecurringProductPriceCustom' fixed: $ref: '#/components/schemas/LegacyRecurringProductPriceFixed' ProductPrice: oneOf: - $ref: '#/components/schemas/ProductPriceFixed' - $ref: '#/components/schemas/ProductPriceCustom' - $ref: '#/components/schemas/ProductPriceSeatBased' - $ref: '#/components/schemas/ProductPriceMeteredUnit' discriminator: propertyName: amount_type mapping: custom: $ref: '#/components/schemas/ProductPriceCustom' fixed: $ref: '#/components/schemas/ProductPriceFixed' metered_unit: $ref: '#/components/schemas/ProductPriceMeteredUnit' seat_based: $ref: '#/components/schemas/ProductPriceSeatBased' Benefit: oneOf: - $ref: '#/components/schemas/BenefitCustom' - $ref: '#/components/schemas/BenefitDiscord' - $ref: '#/components/schemas/BenefitGitHubRepository' - $ref: '#/components/schemas/BenefitDownloadables' - $ref: '#/components/schemas/BenefitLicenseKeys' - $ref: '#/components/schemas/BenefitMeterCredit' - $ref: '#/components/schemas/BenefitFeatureFlag' - $ref: '#/components/schemas/BenefitSlackSharedChannel' discriminator: propertyName: type mapping: custom: $ref: '#/components/schemas/BenefitCustom' discord: $ref: '#/components/schemas/BenefitDiscord' downloadables: $ref: '#/components/schemas/BenefitDownloadables' feature_flag: $ref: '#/components/schemas/BenefitFeatureFlag' github_repository: $ref: '#/components/schemas/BenefitGitHubRepository' license_keys: $ref: '#/components/schemas/BenefitLicenseKeys' meter_credit: $ref: '#/components/schemas/BenefitMeterCredit' slack_shared_channel: $ref: '#/components/schemas/BenefitSlackSharedChannel' ProductMediaFileRead: properties: id: type: string format: uuid4 title: Id description: The stable identifier for this record. organization_id: type: string format: uuid4 title: Organization Id name: type: string title: Name path: type: string title: Path mime_type: type: string title: Mime Type size: type: integer title: Size storage_version: anyOf: - type: string - type: 'null' title: Storage Version checksum_etag: anyOf: - type: string - type: 'null' title: Checksum Etag checksum_sha256_base64: anyOf: - type: string - type: 'null' title: Checksum Sha256 Base64 checksum_sha256_hex: anyOf: - type: string - type: 'null' title: Checksum Sha256 Hex last_modified_at: anyOf: - type: string format: date-time - type: 'null' title: Last Modified At version: anyOf: - type: string - type: 'null' title: Version service: type: string const: product_media title: Service is_uploaded: type: boolean title: Is Uploaded created_at: type: string format: date-time title: Created At size_readable: type: string title: Size Readable readOnly: true public_url: type: string title: Public Url readOnly: true type: object required: - id - organization_id - name - path - mime_type - size - storage_version - checksum_etag - checksum_sha256_base64 - checksum_sha256_hex - last_modified_at - version - service - is_uploaded - created_at - size_readable - public_url title: ProductMediaFileRead description: File to be used as a product media file. AttachedCustomField: properties: custom_field_id: type: string format: uuid4 title: Custom Field Id description: Identifier of the custom field. custom_field: $ref: '#/components/schemas/CustomField' title: CustomField order: type: integer title: Order description: '**Order:** Order of the custom field in the resource.' required: type: boolean title: Required description: Indicates whether the value is required for this custom field. type: object required: - custom_field_id - custom_field - order - required title: AttachedCustomField description: Schema of a custom field attached to a resource. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ProductPriceFixedCreate: properties: amount_type: type: string const: fixed title: Amount Type price_currency: $ref: '#/components/schemas/PresentmentCurrency' description: '**Price Currency:** Currency in which the customer will be charged.' default: usd tax_behavior: anyOf: - $ref: '#/components/schemas/TaxBehaviorOption' - type: 'null' description: >- **Tax Behavior:** Tax behavior of the price. If not set, it will default to the organization's default tax behavior. price_amount: type: integer minimum: 0 title: Price Amount description: |- The price in cents. Set to `0` for a free price. Minimum amounts per currency: - USD: 0.5 - AED: 2 - ALL: 50 - AMD: 200 - AOA: 500 - ARS: 750 - AUD: 0.7 - AWG: 1 - AZN: 1 - BAM: 1 - BBD: 2 - BDT: 70 - BIF: 2,000 - BMD: 1 - BND: 1 - BOB: 5 - BRL: 2.5 - BSD: 1 - BWP: 10 - BZD: 2 - CAD: 0.7 - CDF: 2,000 - CHF: 0.5 - CLP: 500 - CNY: 5 - COP: 2,000 - CRC: 300 - CVE: 50 - CZK: 15 - DJF: 100 - DKK: 3.2 - DOP: 40 - DZD: 70 - EGP: 30 - ETB: 80 - EUR: 0.5 - FJD: 2 - FKP: 1 - GBP: 0.4 - GEL: 2 - GNF: 5,000 - GIP: 1 - GMD: 40 - GTQ: 5 - GYD: 200 - HKD: 4 - HNL: 20 - HTG: 70 - HUF: 175 - IDR: 9,000 - ILS: 1.5 - INR: 60 - ISK: 70 - JMD: 80 - JPY: 80 - KES: 70 - KGS: 50 - KHR: 3,000 - KMF: 500 - KRW: 800 - KYD: 1 - KZT: 300 - LAK: 20,000 - LKR: 200 - LRD: 100 - LSL: 10 - MAD: 5 - MDL: 10 - MGA: 3,000 - MKD: 50 - MNT: 2,000 - MOP: 5 - MUR: 50 - MVR: 8 - MXN: 9 - MWK: 1,000 - MYR: 2 - MZN: 50 - NAD: 10 - NGN: 700 - NIO: 20 - NOK: 5 - NPR: 80 - NZD: 0.9 - PAB: 1 - PEN: 2 - PGK: 3 - PHP: 35 - PKR: 200 - PLN: 2 - PYG: 4,000 - QAR: 2 - RON: 2.5 - RSD: 60 - RWF: 1,000 - SAR: 2 - SBD: 4 - SCR: 8 - SEK: 5 - SGD: 0.7 - SHP: 1 - SOS: 500 - SRD: 20 - SZL: 10 - THB: 20 - TJS: 5 - TOP: 2 - TRY: 30 - TTD: 4 - TWD: 20 - TZS: 2,000 - UAH: 30 - UGX: 2,000 - UYU: 20 - UZS: 7,000 - VND: 20,000 - VUV: 100 - WST: 2 - XAF: 500 - XCD: 2 - XCG: 1 - XOF: 500 - XPF: 100 - YER: 200 - ZAR: 9 - ZMW: 10 - Other currencies: 50 minor units type: object required: - amount_type - price_amount title: ProductPriceFixedCreate description: Schema used to create a fixed price. ProductPriceCustomCreate: properties: amount_type: type: string const: custom title: Amount Type price_currency: $ref: '#/components/schemas/PresentmentCurrency' description: '**Price Currency:** Currency in which the customer will be charged.' default: usd tax_behavior: anyOf: - $ref: '#/components/schemas/TaxBehaviorOption' - type: 'null' description: >- **Tax Behavior:** Tax behavior of the price. If not set, it will default to the organization's default tax behavior. minimum_amount: type: integer minimum: 0 title: Minimum Amount description: >- The minimum amount the customer can pay. If set to 0, the price is 'free or pay what you want' and $0 is accepted. If set to a value below the minimum price amount for the currency, it will be rejected. Defaults to the minimum price amount for the currency. Minimum per currency: - USD: 0.5 - AED: 2 - ALL: 50 - AMD: 200 - AOA: 500 - ARS: 750 - AUD: 0.7 - AWG: 1 - AZN: 1 - BAM: 1 - BBD: 2 - BDT: 70 - BIF: 2,000 - BMD: 1 - BND: 1 - BOB: 5 - BRL: 2.5 - BSD: 1 - BWP: 10 - BZD: 2 - CAD: 0.7 - CDF: 2,000 - CHF: 0.5 - CLP: 500 - CNY: 5 - COP: 2,000 - CRC: 300 - CVE: 50 - CZK: 15 - DJF: 100 - DKK: 3.2 - DOP: 40 - DZD: 70 - EGP: 30 - ETB: 80 - EUR: 0.5 - FJD: 2 - FKP: 1 - GBP: 0.4 - GEL: 2 - GNF: 5,000 - GIP: 1 - GMD: 40 - GTQ: 5 - GYD: 200 - HKD: 4 - HNL: 20 - HTG: 70 - HUF: 175 - IDR: 9,000 - ILS: 1.5 - INR: 60 - ISK: 70 - JMD: 80 - JPY: 80 - KES: 70 - KGS: 50 - KHR: 3,000 - KMF: 500 - KRW: 800 - KYD: 1 - KZT: 300 - LAK: 20,000 - LKR: 200 - LRD: 100 - LSL: 10 - MAD: 5 - MDL: 10 - MGA: 3,000 - MKD: 50 - MNT: 2,000 - MOP: 5 - MUR: 50 - MVR: 8 - MXN: 9 - MWK: 1,000 - MYR: 2 - MZN: 50 - NAD: 10 - NGN: 700 - NIO: 20 - NOK: 5 - NPR: 80 - NZD: 0.9 - PAB: 1 - PEN: 2 - PGK: 3 - PHP: 35 - PKR: 200 - PLN: 2 - PYG: 4,000 - QAR: 2 - RON: 2.5 - RSD: 60 - RWF: 1,000 - SAR: 2 - SBD: 4 - SCR: 8 - SEK: 5 - SGD: 0.7 - SHP: 1 - SOS: 500 - SRD: 20 - SZL: 10 - THB: 20 - TJS: 5 - TOP: 2 - TRY: 30 - TTD: 4 - TWD: 20 - TZS: 2,000 - UAH: 30 - UGX: 2,000 - UYU: 20 - UZS: 7,000 - VND: 20,000 - VUV: 100 - WST: 2 - XAF: 500 - XCD: 2 - XCG: 1 - XOF: 500 - XPF: 100 - YER: 200 - ZAR: 9 - ZMW: 10 - Other currencies: 50 minor units default: 50 maximum_amount: anyOf: - type: integer minimum: 1 description: |- The price in cents. Minimum amounts per currency: - USD: 0.5 - AED: 2 - ALL: 50 - AMD: 200 - AOA: 500 - ARS: 750 - AUD: 0.7 - AWG: 1 - AZN: 1 - BAM: 1 - BBD: 2 - BDT: 70 - BIF: 2,000 - BMD: 1 - BND: 1 - BOB: 5 - BRL: 2.5 - BSD: 1 - BWP: 10 - BZD: 2 - CAD: 0.7 - CDF: 2,000 - CHF: 0.5 - CLP: 500 - CNY: 5 - COP: 2,000 - CRC: 300 - CVE: 50 - CZK: 15 - DJF: 100 - DKK: 3.2 - DOP: 40 - DZD: 70 - EGP: 30 - ETB: 80 - EUR: 0.5 - FJD: 2 - FKP: 1 - GBP: 0.4 - GEL: 2 - GNF: 5,000 - GIP: 1 - GMD: 40 - GTQ: 5 - GYD: 200 - HKD: 4 - HNL: 20 - HTG: 70 - HUF: 175 - IDR: 9,000 - ILS: 1.5 - INR: 60 - ISK: 70 - JMD: 80 - JPY: 80 - KES: 70 - KGS: 50 - KHR: 3,000 - KMF: 500 - KRW: 800 - KYD: 1 - KZT: 300 - LAK: 20,000 - LKR: 200 - LRD: 100 - LSL: 10 - MAD: 5 - MDL: 10 - MGA: 3,000 - MKD: 50 - MNT: 2,000 - MOP: 5 - MUR: 50 - MVR: 8 - MXN: 9 - MWK: 1,000 - MYR: 2 - MZN: 50 - NAD: 10 - NGN: 700 - NIO: 20 - NOK: 5 - NPR: 80 - NZD: 0.9 - PAB: 1 - PEN: 2 - PGK: 3 - PHP: 35 - PKR: 200 - PLN: 2 - PYG: 4,000 - QAR: 2 - RON: 2.5 - RSD: 60 - RWF: 1,000 - SAR: 2 - SBD: 4 - SCR: 8 - SEK: 5 - SGD: 0.7 - SHP: 1 - SOS: 500 - SRD: 20 - SZL: 10 - THB: 20 - TJS: 5 - TOP: 2 - TRY: 30 - TTD: 4 - TWD: 20 - TZS: 2,000 - UAH: 30 - UGX: 2,000 - UYU: 20 - UZS: 7,000 - VND: 20,000 - VUV: 100 - WST: 2 - XAF: 500 - XCD: 2 - XCG: 1 - XOF: 500 - XPF: 100 - YER: 200 - ZAR: 9 - ZMW: 10 - Other currencies: 50 minor units - type: 'null' title: Maximum Amount description: |- The maximum amount the customer can pay. Maximum per currency: - USD: 999,999.99 - EUR: 999,999.99 - GBP: 999,999.99 - ARS: 1,400,000 - CDF: 2,800,000 - COP: 4,000,000 - IDR: 16,000,000 - KHR: 4,000,000 - LAK: 21,000,000 - MNT: 3,500,000 - MWK: 1,750,000 - NGN: 1,550,000 - TZS: 2,500,000 - UGX: 3,700,000 - UZS: 12,500,000 - Other currencies: 99,999,999 minor units preset_amount: anyOf: - type: integer minimum: 0 description: |- The price in cents. Minimum amounts per currency: - USD: 0.5 - AED: 2 - ALL: 50 - AMD: 200 - AOA: 500 - ARS: 750 - AUD: 0.7 - AWG: 1 - AZN: 1 - BAM: 1 - BBD: 2 - BDT: 70 - BIF: 2,000 - BMD: 1 - BND: 1 - BOB: 5 - BRL: 2.5 - BSD: 1 - BWP: 10 - BZD: 2 - CAD: 0.7 - CDF: 2,000 - CHF: 0.5 - CLP: 500 - CNY: 5 - COP: 2,000 - CRC: 300 - CVE: 50 - CZK: 15 - DJF: 100 - DKK: 3.2 - DOP: 40 - DZD: 70 - EGP: 30 - ETB: 80 - EUR: 0.5 - FJD: 2 - FKP: 1 - GBP: 0.4 - GEL: 2 - GNF: 5,000 - GIP: 1 - GMD: 40 - GTQ: 5 - GYD: 200 - HKD: 4 - HNL: 20 - HTG: 70 - HUF: 175 - IDR: 9,000 - ILS: 1.5 - INR: 60 - ISK: 70 - JMD: 80 - JPY: 80 - KES: 70 - KGS: 50 - KHR: 3,000 - KMF: 500 - KRW: 800 - KYD: 1 - KZT: 300 - LAK: 20,000 - LKR: 200 - LRD: 100 - LSL: 10 - MAD: 5 - MDL: 10 - MGA: 3,000 - MKD: 50 - MNT: 2,000 - MOP: 5 - MUR: 50 - MVR: 8 - MXN: 9 - MWK: 1,000 - MYR: 2 - MZN: 50 - NAD: 10 - NGN: 700 - NIO: 20 - NOK: 5 - NPR: 80 - NZD: 0.9 - PAB: 1 - PEN: 2 - PGK: 3 - PHP: 35 - PKR: 200 - PLN: 2 - PYG: 4,000 - QAR: 2 - RON: 2.5 - RSD: 60 - RWF: 1,000 - SAR: 2 - SBD: 4 - SCR: 8 - SEK: 5 - SGD: 0.7 - SHP: 1 - SOS: 500 - SRD: 20 - SZL: 10 - THB: 20 - TJS: 5 - TOP: 2 - TRY: 30 - TTD: 4 - TWD: 20 - TZS: 2,000 - UAH: 30 - UGX: 2,000 - UYU: 20 - UZS: 7,000 - VND: 20,000 - VUV: 100 - WST: 2 - XAF: 500 - XCD: 2 - XCG: 1 - XOF: 500 - XPF: 100 - YER: 200 - ZAR: 9 - ZMW: 10 - Other currencies: 50 minor units - type: 'null' title: Preset Amount description: >- The initial amount shown to the customer. If 0, the customer will see $0 as the default. If set to a value below the minimum price amount for the currency, it will be rejected.Minimum per currency: - USD: 0.5 - AED: 2 - ALL: 50 - AMD: 200 - AOA: 500 - ARS: 750 - AUD: 0.7 - AWG: 1 - AZN: 1 - BAM: 1 - BBD: 2 - BDT: 70 - BIF: 2,000 - BMD: 1 - BND: 1 - BOB: 5 - BRL: 2.5 - BSD: 1 - BWP: 10 - BZD: 2 - CAD: 0.7 - CDF: 2,000 - CHF: 0.5 - CLP: 500 - CNY: 5 - COP: 2,000 - CRC: 300 - CVE: 50 - CZK: 15 - DJF: 100 - DKK: 3.2 - DOP: 40 - DZD: 70 - EGP: 30 - ETB: 80 - EUR: 0.5 - FJD: 2 - FKP: 1 - GBP: 0.4 - GEL: 2 - GNF: 5,000 - GIP: 1 - GMD: 40 - GTQ: 5 - GYD: 200 - HKD: 4 - HNL: 20 - HTG: 70 - HUF: 175 - IDR: 9,000 - ILS: 1.5 - INR: 60 - ISK: 70 - JMD: 80 - JPY: 80 - KES: 70 - KGS: 50 - KHR: 3,000 - KMF: 500 - KRW: 800 - KYD: 1 - KZT: 300 - LAK: 20,000 - LKR: 200 - LRD: 100 - LSL: 10 - MAD: 5 - MDL: 10 - MGA: 3,000 - MKD: 50 - MNT: 2,000 - MOP: 5 - MUR: 50 - MVR: 8 - MXN: 9 - MWK: 1,000 - MYR: 2 - MZN: 50 - NAD: 10 - NGN: 700 - NIO: 20 - NOK: 5 - NPR: 80 - NZD: 0.9 - PAB: 1 - PEN: 2 - PGK: 3 - PHP: 35 - PKR: 200 - PLN: 2 - PYG: 4,000 - QAR: 2 - RON: 2.5 - RSD: 60 - RWF: 1,000 - SAR: 2 - SBD: 4 - SCR: 8 - SEK: 5 - SGD: 0.7 - SHP: 1 - SOS: 500 - SRD: 20 - SZL: 10 - THB: 20 - TJS: 5 - TOP: 2 - TRY: 30 - TTD: 4 - TWD: 20 - TZS: 2,000 - UAH: 30 - UGX: 2,000 - UYU: 20 - UZS: 7,000 - VND: 20,000 - VUV: 100 - WST: 2 - XAF: 500 - XCD: 2 - XCG: 1 - XOF: 500 - XPF: 100 - YER: 200 - ZAR: 9 - ZMW: 10 - Other currencies: 50 minor units type: object required: - amount_type title: ProductPriceCustomCreate description: Schema used to create a pay-what-you-want price. ProductPriceSeatBasedCreate: properties: amount_type: type: string const: seat_based title: Amount Type price_currency: $ref: '#/components/schemas/PresentmentCurrency' description: '**Price Currency:** Currency in which the customer will be charged.' default: usd tax_behavior: anyOf: - $ref: '#/components/schemas/TaxBehaviorOption' - type: 'null' description: >- **Tax Behavior:** Tax behavior of the price. If not set, it will default to the organization's default tax behavior. seat_tiers: $ref: '#/components/schemas/ProductPriceSeatTiers-Input' description: '**Seat Tiers:** Tiered pricing based on seat quantity.' type: object required: - amount_type - seat_tiers title: ProductPriceSeatBasedCreate description: Schema used to create a seat-based price with volume-based tiers. ProductPriceMeteredUnitCreate: properties: amount_type: type: string const: metered_unit title: Amount Type price_currency: $ref: '#/components/schemas/PresentmentCurrency' description: '**Price Currency:** Currency in which the customer will be charged.' default: usd tax_behavior: anyOf: - $ref: '#/components/schemas/TaxBehaviorOption' - type: 'null' description: >- **Tax Behavior:** Tax behavior of the price. If not set, it will default to the organization's default tax behavior. meter_id: type: string format: uuid4 title: Meter Id description: Unique identifier for the meter associated to the price. unit_amount: anyOf: - type: number exclusiveMinimum: 0 - type: string pattern: >- ^(?!^[-+.]*$)[+-]?0*(?:\d{0,5}|(?=[\d.]{1,18}0*$)\d{0,5}\.\d{0,12}0*$) title: Unit Amount description: >- **Unit Amount:** Price per unit in cents. Supports up to 12 decimal places. cap_amount: anyOf: - type: integer maximum: 2147483647 minimum: 0 - type: 'null' title: Cap Amount description: >- **Cap Amount:** Optional maximum amount in cents that can be charged, regardless of the number of units consumed. type: object required: - amount_type - meter_id - unit_amount title: ProductPriceMeteredUnitCreate description: Schema used to create a metered price with a fixed unit price. AttachedCustomFieldCreate: properties: custom_field_id: type: string format: uuid4 title: Custom Field Id description: Identifier of the custom field to attach. required: type: boolean title: Required description: Indicates whether the value is required for this custom field. type: object required: - custom_field_id - required title: AttachedCustomFieldCreate description: Schema to attach a custom field to a resource. LegacyRecurringProductPriceFixed: properties: created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. id: type: string format: uuid4 title: Id description: Unique identifier for the price. source: $ref: '#/components/schemas/ProductPriceSource' description: >- **Source:** Source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session. amount_type: type: string const: fixed title: Amount Type price_currency: type: string title: Price Currency description: '**Price Currency:** Currency in which the customer will be charged.' tax_behavior: anyOf: - $ref: '#/components/schemas/TaxBehaviorOption' - type: 'null' description: >- **Tax Behavior:** Tax behavior of the price. If null, it defaults to the organization's default tax behavior. is_archived: type: boolean title: Is Archived description: Indicates whether the price is archived and no longer available. product_id: type: string format: uuid4 title: Product Id description: Unique identifier for the product owning the price. type: type: string const: recurring title: Type description: '**Type:** Type of the price.' recurring_interval: $ref: '#/components/schemas/RecurringInterval' description: '**Recurring Interval:** Recurring interval of the price.' price_amount: type: integer title: Price Amount description: '**Price Amount:** Price in cents.' legacy: type: boolean const: true title: Legacy readOnly: true type: object required: - created_at - modified_at - id - source - amount_type - price_currency - tax_behavior - is_archived - product_id - type - recurring_interval - price_amount - legacy title: LegacyRecurringProductPriceFixed description: >- A recurring price for a product, i.e. a subscription. **Deprecated**: The recurring interval should be set on the product itself. LegacyRecurringProductPriceCustom: properties: created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. id: type: string format: uuid4 title: Id description: Unique identifier for the price. source: $ref: '#/components/schemas/ProductPriceSource' description: >- **Source:** Source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session. amount_type: type: string const: custom title: Amount Type price_currency: type: string title: Price Currency description: '**Price Currency:** Currency in which the customer will be charged.' tax_behavior: anyOf: - $ref: '#/components/schemas/TaxBehaviorOption' - type: 'null' description: >- **Tax Behavior:** Tax behavior of the price. If null, it defaults to the organization's default tax behavior. is_archived: type: boolean title: Is Archived description: Indicates whether the price is archived and no longer available. product_id: type: string format: uuid4 title: Product Id description: Unique identifier for the product owning the price. type: type: string const: recurring title: Type description: '**Type:** Type of the price.' recurring_interval: $ref: '#/components/schemas/RecurringInterval' description: '**Recurring Interval:** Recurring interval of the price.' minimum_amount: type: integer title: Minimum Amount description: >- **Minimum Amount:** Minimum amount the customer can pay. If 0, the price is 'free or pay what you want'. maximum_amount: anyOf: - type: integer - type: 'null' title: Maximum Amount description: '**Maximum Amount:** Maximum amount the customer can pay.' preset_amount: anyOf: - type: integer - type: 'null' title: Preset Amount description: '**Preset Amount:** Initial amount shown to the customer.' legacy: type: boolean const: true title: Legacy readOnly: true type: object required: - created_at - modified_at - id - source - amount_type - price_currency - tax_behavior - is_archived - product_id - type - recurring_interval - minimum_amount - maximum_amount - preset_amount - legacy title: LegacyRecurringProductPriceCustom description: >- A pay-what-you-want recurring price for a product, i.e. a subscription. **Deprecated**: The recurring interval should be set on the product itself. ProductPriceFixed: properties: created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. id: type: string format: uuid4 title: Id description: Unique identifier for the price. source: $ref: '#/components/schemas/ProductPriceSource' description: >- **Source:** Source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session. amount_type: type: string const: fixed title: Amount Type price_currency: type: string title: Price Currency description: '**Price Currency:** Currency in which the customer will be charged.' tax_behavior: anyOf: - $ref: '#/components/schemas/TaxBehaviorOption' - type: 'null' description: >- **Tax Behavior:** Tax behavior of the price. If null, it defaults to the organization's default tax behavior. is_archived: type: boolean title: Is Archived description: Indicates whether the price is archived and no longer available. product_id: type: string format: uuid4 title: Product Id description: Unique identifier for the product owning the price. price_amount: type: integer title: Price Amount description: '**Price Amount:** Price in cents.' type: object required: - created_at - modified_at - id - source - amount_type - price_currency - tax_behavior - is_archived - product_id - price_amount title: ProductPriceFixed description: Object representing fixed price for a product. ProductPriceCustom: properties: created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. id: type: string format: uuid4 title: Id description: Unique identifier for the price. source: $ref: '#/components/schemas/ProductPriceSource' description: >- **Source:** Source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session. amount_type: type: string const: custom title: Amount Type price_currency: type: string title: Price Currency description: '**Price Currency:** Currency in which the customer will be charged.' tax_behavior: anyOf: - $ref: '#/components/schemas/TaxBehaviorOption' - type: 'null' description: >- **Tax Behavior:** Tax behavior of the price. If null, it defaults to the organization's default tax behavior. is_archived: type: boolean title: Is Archived description: Indicates whether the price is archived and no longer available. product_id: type: string format: uuid4 title: Product Id description: Unique identifier for the product owning the price. minimum_amount: type: integer title: Minimum Amount description: >- **Minimum Amount:** Minimum amount the customer can pay. If 0, the price is 'free or pay what you want'. maximum_amount: anyOf: - type: integer - type: 'null' title: Maximum Amount description: '**Maximum Amount:** Maximum amount the customer can pay.' preset_amount: anyOf: - type: integer - type: 'null' title: Preset Amount description: '**Preset Amount:** Initial amount shown to the customer.' type: object required: - created_at - modified_at - id - source - amount_type - price_currency - tax_behavior - is_archived - product_id - minimum_amount - maximum_amount - preset_amount title: ProductPriceCustom description: Object representing pay-what-you-want price for a product. ProductPriceSeatBased: properties: created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. id: type: string format: uuid4 title: Id description: Unique identifier for the price. source: $ref: '#/components/schemas/ProductPriceSource' description: >- **Source:** Source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session. amount_type: type: string const: seat_based title: Amount Type price_currency: type: string title: Price Currency description: '**Price Currency:** Currency in which the customer will be charged.' tax_behavior: anyOf: - $ref: '#/components/schemas/TaxBehaviorOption' - type: 'null' description: >- **Tax Behavior:** Tax behavior of the price. If null, it defaults to the organization's default tax behavior. is_archived: type: boolean title: Is Archived description: Indicates whether the price is archived and no longer available. product_id: type: string format: uuid4 title: Product Id description: Unique identifier for the product owning the price. seat_tiers: $ref: '#/components/schemas/ProductPriceSeatTiers-Output' description: '**Seat Tiers:** Tiered pricing based on seat quantity.' type: object required: - created_at - modified_at - id - source - amount_type - price_currency - tax_behavior - is_archived - product_id - seat_tiers title: ProductPriceSeatBased description: Object representing seat-based price for a product. ProductPriceMeteredUnit: properties: created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. id: type: string format: uuid4 title: Id description: Unique identifier for the price. source: $ref: '#/components/schemas/ProductPriceSource' description: >- **Source:** Source of the price . `catalog` is a predefined price, while `ad_hoc` is a price created dynamically on a Checkout session. amount_type: type: string const: metered_unit title: Amount Type price_currency: type: string title: Price Currency description: '**Price Currency:** Currency in which the customer will be charged.' tax_behavior: anyOf: - $ref: '#/components/schemas/TaxBehaviorOption' - type: 'null' description: >- **Tax Behavior:** Tax behavior of the price. If null, it defaults to the organization's default tax behavior. is_archived: type: boolean title: Is Archived description: Indicates whether the price is archived and no longer available. product_id: type: string format: uuid4 title: Product Id description: Unique identifier for the product owning the price. unit_amount: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Unit Amount description: '**Unit Amount:** Price per unit in cents.' cap_amount: anyOf: - type: integer - type: 'null' title: Cap Amount description: >- **Cap Amount:** Maximum amount in cents that can be charged, regardless of the number of units consumed. meter_id: type: string format: uuid4 title: Meter Id description: Unique identifier for the meter associated to the price. meter: $ref: '#/components/schemas/ProductPriceMeter' description: '**Meter:** Meter associated to the price.' type: object required: - created_at - modified_at - id - source - amount_type - price_currency - tax_behavior - is_archived - product_id - unit_amount - cap_amount - meter_id - meter title: ProductPriceMeteredUnit description: >- Object representing metered, usage-based, price for a product, with a fixed unit price. BenefitCustom: properties: id: type: string format: uuid4 title: Id description: Unique identifier for the benefit. created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. type: type: string const: custom title: Type description: type: string title: Description description: Description attached to the benefit. selectable: type: boolean title: Selectable description: Indicates whether the benefit is selectable when creating a product. deletable: type: boolean title: Deletable description: Indicates whether the benefit is deletable. is_deleted: type: boolean title: Is Deleted description: Indicates whether the benefit is deleted. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the benefit. metadata: $ref: '#/components/schemas/MetadataOutputType' visibility: $ref: '#/components/schemas/BenefitVisibility' description: >- **Visibility:** Controls whether customers can see this benefit in their portal. properties: $ref: '#/components/schemas/BenefitCustomProperties' visibility_configurable: type: boolean title: Visibility Configurable readOnly: true type: object required: - id - created_at - modified_at - type - description - selectable - deletable - is_deleted - organization_id - metadata - visibility - properties - visibility_configurable title: BenefitCustom description: |- A benefit of type `custom`. Use it to grant any kind of benefit that doesn't fit in the other types. BenefitDiscord: properties: id: type: string format: uuid4 title: Id description: Unique identifier for the benefit. created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. type: type: string const: discord title: Type description: type: string title: Description description: Description attached to the benefit. selectable: type: boolean title: Selectable description: Indicates whether the benefit is selectable when creating a product. deletable: type: boolean title: Deletable description: Indicates whether the benefit is deletable. is_deleted: type: boolean title: Is Deleted description: Indicates whether the benefit is deleted. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the benefit. metadata: $ref: '#/components/schemas/MetadataOutputType' visibility: $ref: '#/components/schemas/BenefitVisibility' description: >- **Visibility:** Controls whether customers can see this benefit in their portal. properties: $ref: '#/components/schemas/BenefitDiscordProperties' visibility_configurable: type: boolean title: Visibility Configurable readOnly: true type: object required: - id - created_at - modified_at - type - description - selectable - deletable - is_deleted - organization_id - metadata - visibility - properties - visibility_configurable title: BenefitDiscord description: |- A benefit of type `discord`. Use it to automatically invite your backers to a Discord server. BenefitGitHubRepository: properties: id: type: string format: uuid4 title: Id description: Unique identifier for the benefit. created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. type: type: string const: github_repository title: Type description: type: string title: Description description: Description attached to the benefit. selectable: type: boolean title: Selectable description: Indicates whether the benefit is selectable when creating a product. deletable: type: boolean title: Deletable description: Indicates whether the benefit is deletable. is_deleted: type: boolean title: Is Deleted description: Indicates whether the benefit is deleted. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the benefit. metadata: $ref: '#/components/schemas/MetadataOutputType' visibility: $ref: '#/components/schemas/BenefitVisibility' description: >- **Visibility:** Controls whether customers can see this benefit in their portal. properties: $ref: '#/components/schemas/BenefitGitHubRepositoryProperties' visibility_configurable: type: boolean title: Visibility Configurable readOnly: true type: object required: - id - created_at - modified_at - type - description - selectable - deletable - is_deleted - organization_id - metadata - visibility - properties - visibility_configurable title: BenefitGitHubRepository description: >- A benefit of type `github_repository`. Use it to automatically invite your backers to a private GitHub repository. BenefitDownloadables: properties: id: type: string format: uuid4 title: Id description: Unique identifier for the benefit. created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. type: type: string const: downloadables title: Type description: type: string title: Description description: Description attached to the benefit. selectable: type: boolean title: Selectable description: Indicates whether the benefit is selectable when creating a product. deletable: type: boolean title: Deletable description: Indicates whether the benefit is deletable. is_deleted: type: boolean title: Is Deleted description: Indicates whether the benefit is deleted. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the benefit. metadata: $ref: '#/components/schemas/MetadataOutputType' visibility: $ref: '#/components/schemas/BenefitVisibility' description: >- **Visibility:** Controls whether customers can see this benefit in their portal. properties: $ref: '#/components/schemas/BenefitDownloadablesProperties' visibility_configurable: type: boolean title: Visibility Configurable readOnly: true type: object required: - id - created_at - modified_at - type - description - selectable - deletable - is_deleted - organization_id - metadata - visibility - properties - visibility_configurable title: BenefitDownloadables BenefitLicenseKeys: properties: id: type: string format: uuid4 title: Id description: Unique identifier for the benefit. created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. type: type: string const: license_keys title: Type description: type: string title: Description description: Description attached to the benefit. selectable: type: boolean title: Selectable description: Indicates whether the benefit is selectable when creating a product. deletable: type: boolean title: Deletable description: Indicates whether the benefit is deletable. is_deleted: type: boolean title: Is Deleted description: Indicates whether the benefit is deleted. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the benefit. metadata: $ref: '#/components/schemas/MetadataOutputType' visibility: $ref: '#/components/schemas/BenefitVisibility' description: >- **Visibility:** Controls whether customers can see this benefit in their portal. properties: $ref: '#/components/schemas/BenefitLicenseKeysProperties' visibility_configurable: type: boolean title: Visibility Configurable readOnly: true type: object required: - id - created_at - modified_at - type - description - selectable - deletable - is_deleted - organization_id - metadata - visibility - properties - visibility_configurable title: BenefitLicenseKeys BenefitMeterCredit: properties: id: type: string format: uuid4 title: Id description: Unique identifier for the benefit. created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. type: type: string const: meter_credit title: Type description: type: string title: Description description: Description attached to the benefit. selectable: type: boolean title: Selectable description: Indicates whether the benefit is selectable when creating a product. deletable: type: boolean title: Deletable description: Indicates whether the benefit is deletable. is_deleted: type: boolean title: Is Deleted description: Indicates whether the benefit is deleted. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the benefit. metadata: $ref: '#/components/schemas/MetadataOutputType' visibility: $ref: '#/components/schemas/BenefitVisibility' description: >- **Visibility:** Controls whether customers can see this benefit in their portal. properties: $ref: '#/components/schemas/BenefitMeterCreditProperties' visibility_configurable: type: boolean title: Visibility Configurable readOnly: true type: object required: - id - created_at - modified_at - type - description - selectable - deletable - is_deleted - organization_id - metadata - visibility - properties - visibility_configurable title: BenefitMeterCredit description: |- A benefit of type `meter_unit`. Use it to grant a number of units on a specific meter. BenefitFeatureFlag: properties: id: type: string format: uuid4 title: Id description: Unique identifier for the benefit. created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. type: type: string const: feature_flag title: Type description: type: string title: Description description: Description attached to the benefit. selectable: type: boolean title: Selectable description: Indicates whether the benefit is selectable when creating a product. deletable: type: boolean title: Deletable description: Indicates whether the benefit is deletable. is_deleted: type: boolean title: Is Deleted description: Indicates whether the benefit is deleted. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the benefit. metadata: $ref: '#/components/schemas/MetadataOutputType' visibility: $ref: '#/components/schemas/BenefitVisibility' description: >- **Visibility:** Controls whether customers can see this benefit in their portal. properties: $ref: '#/components/schemas/BenefitFeatureFlagProperties' visibility_configurable: type: boolean title: Visibility Configurable readOnly: true type: object required: - id - created_at - modified_at - type - description - selectable - deletable - is_deleted - organization_id - metadata - visibility - properties - visibility_configurable title: BenefitFeatureFlag description: |- A benefit of type `feature_flag`. Use it to grant feature flags with key-value metadata that can be queried via the API and webhooks. BenefitSlackSharedChannel: properties: id: type: string format: uuid4 title: Id description: Unique identifier for the benefit. created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. type: type: string const: slack_shared_channel title: Type description: type: string title: Description description: Description attached to the benefit. selectable: type: boolean title: Selectable description: Indicates whether the benefit is selectable when creating a product. deletable: type: boolean title: Deletable description: Indicates whether the benefit is deletable. is_deleted: type: boolean title: Is Deleted description: Indicates whether the benefit is deleted. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the benefit. metadata: $ref: '#/components/schemas/MetadataOutputType' visibility: $ref: '#/components/schemas/BenefitVisibility' description: >- **Visibility:** Controls whether customers can see this benefit in their portal. properties: $ref: '#/components/schemas/BenefitSlackSharedChannelProperties' visibility_configurable: type: boolean title: Visibility Configurable readOnly: true type: object required: - id - created_at - modified_at - type - description - selectable - deletable - is_deleted - organization_id - metadata - visibility - properties - visibility_configurable title: BenefitSlackSharedChannel CustomField: oneOf: - $ref: '#/components/schemas/CustomFieldText' - $ref: '#/components/schemas/CustomFieldNumber' - $ref: '#/components/schemas/CustomFieldDate' - $ref: '#/components/schemas/CustomFieldCheckbox' - $ref: '#/components/schemas/CustomFieldSelect' discriminator: propertyName: type mapping: checkbox: $ref: '#/components/schemas/CustomFieldCheckbox' date: $ref: '#/components/schemas/CustomFieldDate' number: $ref: '#/components/schemas/CustomFieldNumber' select: $ref: '#/components/schemas/CustomFieldSelect' text: $ref: '#/components/schemas/CustomFieldText' PresentmentCurrency: type: string enum: - aed - all - amd - aoa - ars - aud - awg - azn - bam - bbd - bdt - bif - bmd - bnd - bob - brl - bsd - bwp - bzd - cad - cdf - chf - clp - cny - cop - crc - cve - czk - djf - dkk - dop - dzd - egp - etb - eur - fjd - fkp - gbp - gel - gip - gmd - gnf - gtq - gyd - hkd - hnl - htg - huf - idr - ils - inr - isk - jmd - jpy - kes - kgs - khr - kmf - krw - kyd - kzt - lak - lkr - lrd - lsl - mad - mdl - mga - mkd - mnt - mop - mur - mvr - mwk - mxn - myr - mzn - nad - ngn - nio - nok - npr - nzd - pab - pen - pgk - php - pkr - pln - pyg - qar - ron - rsd - rwf - sar - sbd - scr - sek - sgd - shp - sos - srd - szl - thb - tjs - top - try - ttd - twd - tzs - uah - ugx - usd - uyu - uzs - vnd - vuv - wst - xaf - xcd - xcg - xof - xpf - yer - zar - zmw title: PresentmentCurrency TaxBehaviorOption: type: string enum: - location - inclusive - exclusive title: TaxBehaviorOption ProductPriceSeatTiers-Input: properties: seat_tier_type: $ref: '#/components/schemas/SeatTierType' description: >- **Seat Tier Type:** How tiers are applied. 'volume' prices all seats at the matching tier's rate. 'graduated' prices each tier's range independently. default: volume tiers: items: $ref: '#/components/schemas/ProductPriceSeatTier' type: array minItems: 1 title: Tiers description: Collection of pricing tiers. type: object required: - tiers title: ProductPriceSeatTiers description: |- List of pricing tiers for seat-based pricing. The minimum and maximum seat limits are derived from the tiers: - minimum_seats = first tier's min_seats - maximum_seats = last tier's max_seats (None for unlimited) ProductPriceSource: type: string enum: - catalog - ad_hoc title: ProductPriceSource ProductPriceSeatTiers-Output: properties: seat_tier_type: $ref: '#/components/schemas/SeatTierType' description: >- **Seat Tier Type:** How tiers are applied. 'volume' prices all seats at the matching tier's rate. 'graduated' prices each tier's range independently. default: volume tiers: items: $ref: '#/components/schemas/ProductPriceSeatTier' type: array minItems: 1 title: Tiers description: Collection of pricing tiers. minimum_seats: type: integer title: Minimum Seats description: >- **Minimum Seats:** Minimum number of seats required for purchase, derived from first tier. readOnly: true maximum_seats: anyOf: - type: integer - type: 'null' title: Maximum Seats description: >- **Maximum Seats:** Maximum number of seats allowed for purchase, derived from last tier. None for unlimited. readOnly: true type: object required: - tiers - minimum_seats - maximum_seats title: ProductPriceSeatTiers description: |- List of pricing tiers for seat-based pricing. The minimum and maximum seat limits are derived from the tiers: - minimum_seats = first tier's min_seats - maximum_seats = last tier's max_seats (None for unlimited) ProductPriceMeter: properties: id: type: string format: uuid4 title: Id description: The stable identifier for this record. name: type: string title: Name description: Name assigned to the meter. unit: $ref: '#/components/schemas/MeterUnit' description: '**Unit:** Unit of the meter.' custom_label: anyOf: - type: string - type: 'null' title: Custom Label description: '**Custom Label:** Label for the custom unit.' custom_multiplier: anyOf: - type: integer - type: 'null' title: Custom Multiplier description: >- **Custom Multiplier:** Multiplier to convert from base unit to display scale. type: object required: - id - name - unit title: ProductPriceMeter description: Object representing meter associated to a metered price. BenefitVisibility: type: string enum: - draft - private - public title: Visibility BenefitCustomProperties: properties: note: anyOf: - anyOf: - type: string - type: 'null' description: >- **Note:** Private note to be shared with customers who have this benefit granted. - type: 'null' title: Note type: object required: - note title: BenefitCustomProperties description: Properties for a benefit of type `custom`. BenefitDiscordProperties: properties: guild_id: type: string title: Guild Id description: Unique identifier for the Discord server. role_id: type: string title: Role Id description: Unique identifier for the Discord role to grant. kick_member: type: boolean title: Kick Member description: >- Indicates whether to kick the member from the Discord server on revocation. guild_token: type: string title: Guild Token readOnly: true type: object required: - guild_id - role_id - kick_member - guild_token title: BenefitDiscordProperties description: Properties for a benefit of type `discord`. BenefitGitHubRepositoryProperties: properties: repository_owner: type: string title: Repository Owner description: '**Repository Owner:** Owner of the repository.' examples: - Rubadot repository_name: type: string title: Repository Name description: Name assigned to the repository. examples: - private_repo permission: type: string enum: - pull - triage - push - maintain - admin title: Permission description: >- **Permission:** Repository access level granted to the customer. See [GitHub repository roles](https://docs.github.com/en/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization#permissions-for-each-role) for the capabilities of each role. type: object required: - repository_owner - repository_name - permission title: BenefitGitHubRepositoryProperties description: Properties for a benefit of type `github_repository`. BenefitDownloadablesProperties: properties: archived: additionalProperties: type: boolean propertyNames: format: uuid4 type: object title: Archived files: items: type: string format: uuid4 type: array title: Files type: object required: - archived - files title: BenefitDownloadablesProperties BenefitLicenseKeysProperties: properties: prefix: anyOf: - type: string - type: 'null' title: Prefix expires: anyOf: - $ref: '#/components/schemas/BenefitLicenseKeyExpirationProperties' - type: 'null' activations: anyOf: - $ref: '#/components/schemas/BenefitLicenseKeyActivationProperties' - type: 'null' limit_usage: anyOf: - type: integer - type: 'null' title: Limit Usage type: object required: - prefix - expires - activations - limit_usage title: BenefitLicenseKeysProperties BenefitMeterCreditProperties: properties: units: type: integer title: Units rollover: type: boolean title: Rollover meter_id: type: string format: uuid4 title: Meter Id type: object required: - units - rollover - meter_id title: BenefitMeterCreditProperties description: Properties for a benefit of type `meter_unit`. BenefitFeatureFlagProperties: properties: {} type: object title: BenefitFeatureFlagProperties description: Properties for a benefit of type `feature_flag`. BenefitSlackSharedChannelProperties: properties: slack_integration_id: type: string format: uuid4 title: Slack Integration Id description: >- **Slack Integration Id:** Ruba Slack integration linked to this benefit. channel_name_template: type: string maxLength: 80 minLength: 1 title: Channel Name Template description: >- **Channel Name Template:** Template for the channel name. Supports placeholders: {customer_name}, {customer_email_local}, and {metadata.} for any value stored in customer user metadata. private: type: boolean title: Private description: '**Private:** Create the channel as private (recommended).' default: true welcome_message: anyOf: - type: string maxLength: 4000 - type: 'null' title: Welcome Message description: >- **Welcome Message:** Optional message posted to the channel right after creation. archive_on_revoke: type: boolean title: Archive On Revoke description: >- **Archive On Revoke:** Archive the channel when the benefit is revoked. default: true team_invitees: items: type: string type: array title: Team Invitees description: >- **Team Invitees:** Slack user IDs from the merchant workspace to invite to every channel created for this benefit. type: object required: - slack_integration_id - channel_name_template title: BenefitSlackSharedChannelProperties CustomFieldText: properties: created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. id: type: string format: uuid4 title: Id description: The stable identifier for this record. metadata: $ref: '#/components/schemas/MetadataOutputType' type: type: string const: text title: Type slug: type: string title: Slug description: '**Slug:** Storage key used for this custom field.' name: type: string title: Name description: Display name assigned to the custom field. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the custom field. examples: - 1dbfc517-0bbf-4301-9ba8-555ca42b9737 x-ruba-selector-widget: displayProperty: name resourceName: Organization resourceRoot: /v1/organizations properties: $ref: '#/components/schemas/CustomFieldTextProperties' type: object required: - created_at - modified_at - id - metadata - type - slug - name - organization_id - properties title: CustomFieldText description: Schema for a custom field of type text. CustomFieldNumber: properties: created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. id: type: string format: uuid4 title: Id description: The stable identifier for this record. metadata: $ref: '#/components/schemas/MetadataOutputType' type: type: string const: number title: Type slug: type: string title: Slug description: '**Slug:** Storage key used for this custom field.' name: type: string title: Name description: Display name assigned to the custom field. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the custom field. examples: - 1dbfc517-0bbf-4301-9ba8-555ca42b9737 x-ruba-selector-widget: displayProperty: name resourceName: Organization resourceRoot: /v1/organizations properties: $ref: '#/components/schemas/CustomFieldNumberProperties' type: object required: - created_at - modified_at - id - metadata - type - slug - name - organization_id - properties title: CustomFieldNumber description: Schema for a custom field of type number. CustomFieldDate: properties: created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. id: type: string format: uuid4 title: Id description: The stable identifier for this record. metadata: $ref: '#/components/schemas/MetadataOutputType' type: type: string const: date title: Type slug: type: string title: Slug description: '**Slug:** Storage key used for this custom field.' name: type: string title: Name description: Display name assigned to the custom field. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the custom field. examples: - 1dbfc517-0bbf-4301-9ba8-555ca42b9737 x-ruba-selector-widget: displayProperty: name resourceName: Organization resourceRoot: /v1/organizations properties: $ref: '#/components/schemas/CustomFieldDateProperties' type: object required: - created_at - modified_at - id - metadata - type - slug - name - organization_id - properties title: CustomFieldDate description: Schema for a custom field of type date. CustomFieldCheckbox: properties: created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. id: type: string format: uuid4 title: Id description: The stable identifier for this record. metadata: $ref: '#/components/schemas/MetadataOutputType' type: type: string const: checkbox title: Type slug: type: string title: Slug description: '**Slug:** Storage key used for this custom field.' name: type: string title: Name description: Display name assigned to the custom field. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the custom field. examples: - 1dbfc517-0bbf-4301-9ba8-555ca42b9737 x-ruba-selector-widget: displayProperty: name resourceName: Organization resourceRoot: /v1/organizations properties: $ref: '#/components/schemas/CustomFieldCheckboxProperties' type: object required: - created_at - modified_at - id - metadata - type - slug - name - organization_id - properties title: CustomFieldCheckbox description: Schema for a custom field of type checkbox. CustomFieldSelect: properties: created_at: type: string format: date-time title: Created At description: The time Ruba created this record. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: The time this record last changed. id: type: string format: uuid4 title: Id description: The stable identifier for this record. metadata: $ref: '#/components/schemas/MetadataOutputType' type: type: string const: select title: Type slug: type: string title: Slug description: '**Slug:** Storage key used for this custom field.' name: type: string title: Name description: Display name assigned to the custom field. organization_id: type: string format: uuid4 title: Organization Id description: Unique identifier for the organization owning the custom field. examples: - 1dbfc517-0bbf-4301-9ba8-555ca42b9737 x-ruba-selector-widget: displayProperty: name resourceName: Organization resourceRoot: /v1/organizations properties: $ref: '#/components/schemas/CustomFieldSelectProperties' type: object required: - created_at - modified_at - id - metadata - type - slug - name - organization_id - properties title: CustomFieldSelect description: Schema for a custom field of type select. SeatTierType: type: string enum: - volume - graduated title: SeatTierType ProductPriceSeatTier: properties: min_seats: type: integer minimum: 1 title: Min Seats description: '**Min Seats:** Minimum number of seats (inclusive).' max_seats: anyOf: - type: integer minimum: 1 - type: 'null' title: Max Seats description: >- **Max Seats:** Maximum number of seats (inclusive). None for unlimited. price_per_seat: type: integer minimum: 0 title: Price Per Seat description: '**Price Per Seat:** Price per seat in cents for this tier.' type: object required: - min_seats - price_per_seat title: ProductPriceSeatTier description: Object representing pricing tier for seat-based pricing. MeterUnit: type: string enum: - scalar - token - custom title: MeterUnit BenefitLicenseKeyExpirationProperties: properties: ttl: type: integer exclusiveMinimum: 0 title: Ttl timeframe: type: string enum: - year - month - day title: Timeframe type: object required: - ttl - timeframe title: BenefitLicenseKeyExpirationProperties BenefitLicenseKeyActivationProperties: properties: limit: type: integer title: Limit enable_customer_admin: type: boolean title: Enable Customer Admin type: object required: - limit - enable_customer_admin title: BenefitLicenseKeyActivationProperties CustomFieldTextProperties: properties: form_label: type: string minLength: 1 title: Form Label form_help_text: type: string minLength: 1 title: Form Help Text form_placeholder: type: string minLength: 1 title: Form Placeholder textarea: type: boolean title: Textarea min_length: type: integer maximum: 2147483647 minimum: 0 title: Min Length max_length: type: integer maximum: 2147483647 minimum: 0 title: Max Length type: object title: CustomFieldTextProperties CustomFieldNumberProperties: properties: form_label: type: string minLength: 1 title: Form Label form_help_text: type: string minLength: 1 title: Form Help Text form_placeholder: type: string minLength: 1 title: Form Placeholder ge: type: integer maximum: 2147483647 minimum: -2147483648 title: Ge le: type: integer maximum: 2147483647 minimum: -2147483648 title: Le type: object title: CustomFieldNumberProperties CustomFieldDateProperties: properties: form_label: type: string minLength: 1 title: Form Label form_help_text: type: string minLength: 1 title: Form Help Text form_placeholder: type: string minLength: 1 title: Form Placeholder ge: type: integer maximum: 2147483647 minimum: -2147483648 title: Ge le: type: integer maximum: 2147483647 minimum: -2147483648 title: Le type: object title: CustomFieldDateProperties CustomFieldCheckboxProperties: properties: form_label: type: string minLength: 1 title: Form Label form_help_text: type: string minLength: 1 title: Form Help Text form_placeholder: type: string minLength: 1 title: Form Placeholder type: object title: CustomFieldCheckboxProperties CustomFieldSelectProperties: properties: form_label: type: string minLength: 1 title: Form Label form_help_text: type: string minLength: 1 title: Form Help Text form_placeholder: type: string minLength: 1 title: Form Placeholder options: items: $ref: '#/components/schemas/CustomFieldSelectOption' type: array minItems: 1 title: Options type: object required: - options title: CustomFieldSelectProperties CustomFieldSelectOption: properties: value: type: string minLength: 1 title: Value label: type: string minLength: 1 title: Label type: object required: - value - label title: CustomFieldSelectOption securitySchemes: oidc: type: openIdConnect openIdConnectUrl: /.well-known/openid-configuration pat: type: http description: >- **Authentication:** You can generate a **Personal Access Token** from your [settings](https://getruba.com/settings). scheme: bearer oat: type: http description: >- **Authentication:** You can generate an **Organization Access Token** from your organization's settings. scheme: bearer ````