# Salesbricks

## Docs

- [Create a customer](https://docs.salesbricks.com/api-reference/customers/create-a-customer.md): Creates a new customer.
- [Create a person for a customer](https://docs.salesbricks.com/api-reference/customers/create-a-person-for-a-customer.md): Creates a new person for a customer.
- [Get a customer](https://docs.salesbricks.com/api-reference/customers/get-a-customer.md): Get a customer by ID.
- [Update a customer](https://docs.salesbricks.com/api-reference/customers/update-a-customer.md): Updates a customer.
- [Update a person for a customer](https://docs.salesbricks.com/api-reference/customers/update-a-person-for-a-customer.md): Updates a person for a customer.
- [Authentication](https://docs.salesbricks.com/api-reference/getting-started/authentication.md)
- [Idempotent Requests](https://docs.salesbricks.com/api-reference/getting-started/idempotent-requests.md)
- [Overview](https://docs.salesbricks.com/api-reference/getting-started/overview.md)
- [Get invoice details](https://docs.salesbricks.com/api-reference/invoices/get-invoice-details.md): Returns the details of a specific invoice.
- [Get invoice PDF](https://docs.salesbricks.com/api-reference/invoices/get-invoice-pdf.md): Returns the url link to the PDF file for the invoice. The URL expires in 1 hour. The download parameter can be used to force download with Content-Disposition header.
- [Get next invoice for subscription](https://docs.salesbricks.com/api-reference/invoices/get-next-invoice-for-subscription.md): Returns the next invoice that will have a non-zero amount for the given subscription
- [Manage My Subscription](https://docs.salesbricks.com/api-reference/manage-my-subscription.md)
- [Get default payment method for subscription](https://docs.salesbricks.com/api-reference/payment-methods/get-default-payment-method-for-subscription.md): Retrieves the default payment method for the subscription's customer.
- [Get payment methods for subscription](https://docs.salesbricks.com/api-reference/payment-methods/get-payment-methods-for-subscription.md): Retrieves all payment methods associated with the subscription's customer. Returns formatted payment method details including cards and bank accounts.
- [Set default payment method for subscription](https://docs.salesbricks.com/api-reference/payment-methods/set-default-payment-method-for-subscription.md): Sets the default payment method for the subscription's customer. The payment method must be a valid Stripe payment method ID attached to the customer.
- [Setup payment methods for subscription](https://docs.salesbricks.com/api-reference/payment-methods/setup-payment-methods-for-subscription.md): Creates a Stripe SetupIntent for adding payment methods to a subscription. Returns the necessary Stripe credentials to initialize the payment form. Supports both card and US bank account payment methods.
- [Get all plans](https://docs.salesbricks.com/api-reference/plans/get-all-plans.md): Returns a paginated list of published plans.This will fetch the plan and the associated bricks for that plan.
- [Get plan details](https://docs.salesbricks.com/api-reference/plans/get-plan-details.md): Returns the details of a plan, including its name and bricks.
- [Creates a new subscription](https://docs.salesbricks.com/api-reference/subscriptions/creates-a-new-subscription.md): Creates a new subscription for a customer.
- [Creates a subscription recast](https://docs.salesbricks.com/api-reference/subscriptions/creates-a-subscription-recast.md): Creates a subscription recast which can be use to replace the terms, dates, and or/or entitlements of a customer's current contract. It essentially scraps the existing agreement and creates a completely new one. Estimate the pricing for the newly created recast order by using the /subscriptions/{subscription_id}/recast/{order_id}/estimate endpoint or start it using the /subscriptions/{subscription_id}/upgrade/{order_id}/start.
- [Creates a subscription upgrade](https://docs.salesbricks.com/api-reference/subscriptions/creates-a-subscription-upgrade.md): Creates a subscription upgrade that can be use to add or remove add-ons from an existing contract term. Estimate the pricing for the newly created upgrade order by using the /subscriptions/{subscription_id}/upgrade/{order_id}/estimate endpoint or start it using the /subscriptions/{subscription_id}/upgrade/{order_id}/start.
- [Delete apiv2subscriptions upgrade](https://docs.salesbricks.com/api-reference/subscriptions/delete-apiv2subscriptions-upgrade.md): PATCH /subscriptions/:subscription_id/upgrade/:order_id

Updates an upgrade order by modifying its bricks and other properties.
- [Deletes an open subscription recast order](https://docs.salesbricks.com/api-reference/subscriptions/deletes-an-open-subscription-recast-order.md): PATCH /subscriptions/:subscription_id/recast/:order_id

Updates a recast order by modifying its bricks and other properties.
- [Get apiv2subscriptions bricks](https://docs.salesbricks.com/api-reference/subscriptions/get-apiv2subscriptions-bricks.md): GET endpoint view that is for getting all the bricks in the
subscription id along with the quantities.
- [Get brick usage for a subscription.](https://docs.salesbricks.com/api-reference/subscriptions/get-brick-usage-for-a-subscription.md): Returns detailed usage metrics for a specific brick within a subscription, including pre-commitment amounts, used quantities, and remaining units. The remaining value can be negative if usage exceeds the pre-commitment amount. If no pre-commitment is set, pre_commitment and remaining will be 0.
- [Get pricing estimate for a subscription](https://docs.salesbricks.com/api-reference/subscriptions/get-pricing-estimate-for-a-subscription.md): Get pricing estimate for a subscription including the billing schedule and grand total for the subscription.
- [Get pricing estimate for a subscription recast](https://docs.salesbricks.com/api-reference/subscriptions/get-pricing-estimate-for-a-subscription-recast.md): Get pricing estimate for an open subscription recast including the billing schedule and grand total.
- [Get pricing estimate for a subscription recast](https://docs.salesbricks.com/api-reference/subscriptions/get-pricing-estimate-for-a-subscription-recast-1.md): Get pricing estimate for an open subscription upgrade including the billing schedule and grand total.
- [Get subscription details](https://docs.salesbricks.com/api-reference/subscriptions/get-subscription-details.md): Returns the current subscription details for the specified ID, including plan name, lifecycle dates, billing information, point of contact, and line items. Use this endpoint to show subscription lifecycle info in user dashboards (e.g., start/end dates, contract renewal dates) and track active plan details.
- [Get subscription invoices](https://docs.salesbricks.com/api-reference/subscriptions/get-subscription-invoices.md): Returns a paginated list of invoices associated with the given subscription. Use this to show invoice history and billing status per subscription, display a timeline of past/current invoices, and let users download or inspect previous and current charges.
- [Get subscription management URL](https://docs.salesbricks.com/api-reference/subscriptions/get-subscription-management-url.md): Get a URL for managing a subscription's billing portal.
- [Get subscription recast open orders](https://docs.salesbricks.com/api-reference/subscriptions/get-subscription-recast-open-orders.md): Returns a list all the open orders for for subscription recast. These are recast orders that hasn't started yet.
- [Get subscription recast sign URL](https://docs.salesbricks.com/api-reference/subscriptions/get-subscription-recast-sign-url.md): Get a URL for signing a subscription's recast open order.
- [Get subscription sign URL](https://docs.salesbricks.com/api-reference/subscriptions/get-subscription-sign-url.md): Get a URL for signing a subscription's open order.
- [Get subscription signed order form pdf](https://docs.salesbricks.com/api-reference/subscriptions/get-subscription-signed-order-form-pdf.md): Returns the url link to the signed order form for the latest order in the subscription. The download parameter can be used to force download with Content-Disposition header.
- [Get subscription upgrade open orders](https://docs.salesbricks.com/api-reference/subscriptions/get-subscription-upgrade-open-orders.md): Returns a list all the open orders for for subscription upgrade. These are upgrade orders that hasn't started yet.
- [Get subscription upgrade sign URL](https://docs.salesbricks.com/api-reference/subscriptions/get-subscription-upgrade-sign-url.md): Get a URL for signing a subscription's upgrade open order.
- [Get the current subscription state](https://docs.salesbricks.com/api-reference/subscriptions/get-the-current-subscription-state.md): Returns the current state of a subscription, including its active status, current billing period, and real-time subscription information. This endpoint is optimized for displaying current subscription state in dashboards and real-time status updates.
- [Post apiv2subscriptions bricks](https://docs.salesbricks.com/api-reference/subscriptions/post-apiv2subscriptions-bricks.md): POST endpoint view available that is limited to creating upgrades that
modify a subscriptions quantities.
- [Start subscription](https://docs.salesbricks.com/api-reference/subscriptions/start-subscription.md): Starts a subscription for the specified ID. This endpoint is used to initiate a subscription and trigger the subscription lifecycle. It returns the subscription details after the start process.
- [Start subscription recast](https://docs.salesbricks.com/api-reference/subscriptions/start-subscription-recast.md): Starts a subscription recast order for the specified subscription and order IDs. This endpoint is used to initiate a recast order and trigger the recast lifecycle. It validates the order is ready to start and processes payment if required. A recast restarts an existing subscription with new terms, typically used for contract amendments or renewals with changes.
- [Start the subscription upgrade](https://docs.salesbricks.com/api-reference/subscriptions/start-the-subscription-upgrade.md): Starts a subscription upgrade order for the specified subscription and order IDs. This endpoint is used to initiate an upgrade order and trigger the upgrade lifecycle with the newly added / removedbricks. It validates the order is ready to start and processes payment if required.
- [Terminate a subscription](https://docs.salesbricks.com/api-reference/subscriptions/terminate-a-subscription.md): Terminates a subscription either immediately or at a specified future date. This endpoint allows for scheduling termination, adding termination notes, and specifying notification emails for termination alerts.
- [Update a subscription](https://docs.salesbricks.com/api-reference/subscriptions/update-a-subscription.md): Update a subscription for a customer.
- [Updates a subscription recast](https://docs.salesbricks.com/api-reference/subscriptions/updates-a-subscription-recast.md): Updates a subscription recast order. This endpoint allows you to modify bricks, AP contacts, and other properties for an existing recast order.
- [Updates a subscription upgrade](https://docs.salesbricks.com/api-reference/subscriptions/updates-a-subscription-upgrade.md): Updates a subscription upgrade order. This endpoint allows you to modify bricks, AP contacts, and other properties for an existing upgrade order.
- [Delete a usage entry](https://docs.salesbricks.com/api-reference/usage/delete.md): Use this API to delete an existing usage entry.
- [Delete apiv2usage](https://docs.salesbricks.com/api-reference/usage/delete-apiv2usage.md)
- [Overview](https://docs.salesbricks.com/api-reference/usage/overview.md)
- [Update a usage entry](https://docs.salesbricks.com/api-reference/usage/patch.md): Use this API to update an existing usage entry.
- [Patch apiv2usage](https://docs.salesbricks.com/api-reference/usage/patch-apiv2usage.md)
- [Submit a usage entry](https://docs.salesbricks.com/api-reference/usage/post.md): Use this API to increment a final value counter for a customer.
- [Post apiv2usage](https://docs.salesbricks.com/api-reference/usage/post-apiv2usage.md)
- [invoice.past.due](https://docs.salesbricks.com/api-reference/webhooks/invoice/past-due.md)
- [Invoice Webhook Payload](https://docs.salesbricks.com/api-reference/webhooks/invoice/payload.md)
- [invoice.payment.failed](https://docs.salesbricks.com/api-reference/webhooks/invoice/payment/failed.md)
- [invoice.payment.succeeded](https://docs.salesbricks.com/api-reference/webhooks/invoice/payment/succeeded.md)
- [invoice.start](https://docs.salesbricks.com/api-reference/webhooks/invoice/start.md)
- [order.closed.delete](https://docs.salesbricks.com/api-reference/webhooks/order/closed-delete.md)
- [order.closed.lost](https://docs.salesbricks.com/api-reference/webhooks/order/closed-lost.md)
- [order.complete](https://docs.salesbricks.com/api-reference/webhooks/order/complete.md)
- [order.end](https://docs.salesbricks.com/api-reference/webhooks/order/end.md)
- [order.new-ramping-period](https://docs.salesbricks.com/api-reference/webhooks/order/new-ramping-period.md)
- [Order Webhook Payload](https://docs.salesbricks.com/api-reference/webhooks/order/payload.md)
- [order.stage.change](https://docs.salesbricks.com/api-reference/webhooks/order/stage-change.md)
- [order.terminated](https://docs.salesbricks.com/api-reference/webhooks/order/terminated.md)
- [Overview](https://docs.salesbricks.com/api-reference/webhooks/overview.md)
- [Payment Webhook Payload](https://docs.salesbricks.com/api-reference/webhooks/payment/payload.md)
- [Schemas](https://docs.salesbricks.com/api-reference/webhooks/schemas.md): In-depth look at webhook payload schemas
- [Countersigning](https://docs.salesbricks.com/documentation/countersigning.md)
- [Custom Billing (Beta)](https://docs.salesbricks.com/documentation/custom-billing.md)
- [Custom email domain](https://docs.salesbricks.com/documentation/custom-email-domain.md): Send customer email notifications from your own domain
- [Customer email notifications](https://docs.salesbricks.com/documentation/customer-email-notifications.md): What emails will Salesbricks send to your customers
- [Deal Shaping](https://docs.salesbricks.com/documentation/deal-shaping.md): Best practices to help you and your customer benefit from a partnership and close the deal
- [Dunning](https://docs.salesbricks.com/documentation/dunning.md): Handling failed payments in Salesbricks
- [Magic Links](https://docs.salesbricks.com/documentation/magic-links.md): Allow your customers to buy from your pricing page via a checkout experience powered by Salesbricks
- [Managing Your Customer](https://docs.salesbricks.com/documentation/managing-your-customer.md): A primer on Upgrades, Renewals, Recasts, and Terminations
- [Order Stages](https://docs.salesbricks.com/documentation/order-stages.md)
- [Order Types](https://docs.salesbricks.com/documentation/order-types.md): Understanding upgrades, renewals, recasts, and terminations
- [Payment Communications](https://docs.salesbricks.com/documentation/payment-communications.md): How to tell your customers that they owe you money
- [Ramping Structures](https://docs.salesbricks.com/documentation/ramping-structures.md)
- [Reports & Charts (Beta)](https://docs.salesbricks.com/documentation/reports-and-charts.md): A primer for Salesbricks' reporting and charting features
- [Taxed States](https://docs.salesbricks.com/documentation/taxed-states.md)
- [Your email notifications](https://docs.salesbricks.com/documentation/your-email-notifications.md): What emails will Salesbricks send to your team
- [Attio (Beta)](https://docs.salesbricks.com/integrations/attio.md)
- [HubSpot](https://docs.salesbricks.com/integrations/hubspot.md)
- [OIN Configuration Setup](https://docs.salesbricks.com/integrations/okta/oin-configuration.md): How to set up Okta Single Sign-On integration
- [Private Integration Setup](https://docs.salesbricks.com/integrations/okta/private-integration.md): How to set up a private Okta integration with Salesbricks
- [Quickbooks](https://docs.salesbricks.com/integrations/quickbooks.md): Quickly and easily connect Salesbricks to Quickbooks to automate your invoice, billing, and accounting workflows.
- [Managed Package](https://docs.salesbricks.com/integrations/salesforce/managed-package.md)
- [Overview](https://docs.salesbricks.com/integrations/salesforce/overview.md)
- [Slack](https://docs.salesbricks.com/integrations/slack.md)
- [Sphere](https://docs.salesbricks.com/integrations/sphere.md)
- [Overview](https://docs.salesbricks.com/integrations/stripe/overview.md)
- [Setup](https://docs.salesbricks.com/integrations/stripe/setup.md): Quick to configure; simple yet powerful integration.
- [Duration Discounts](https://docs.salesbricks.com/orders/duration-discounts.md)
- [Usage Alerts](https://docs.salesbricks.com/products/usage-alerts.md)
- [Adding Team Members](https://docs.salesbricks.com/quickstart-guide/adding-team-members.md)
- [Building an Order](https://docs.salesbricks.com/quickstart-guide/building-an-order.md)
- [Checkout & Invoice Payment Options](https://docs.salesbricks.com/quickstart-guide/checkout-invoice-payment-options.md)
- [Company Details & Branding](https://docs.salesbricks.com/quickstart-guide/company-details-and-branding.md): Tailor your Salesbricks site to your organization
- [Getting Started](https://docs.salesbricks.com/quickstart-guide/getting-started.md)
- [Introduction](https://docs.salesbricks.com/quickstart-guide/introduction.md): Close more deals faster with the simplest way to buy and sell software.
- [Navigating Salesbricks](https://docs.salesbricks.com/quickstart-guide/navigating-salesbricks.md)
- [Creating a Brick](https://docs.salesbricks.com/quickstart-guide/products-plans-bricks/creating-a-brick.md)
- [Creating a Plan](https://docs.salesbricks.com/quickstart-guide/products-plans-bricks/creating-a-plan.md)
- [Creating a Product](https://docs.salesbricks.com/quickstart-guide/products-plans-bricks/creating-a-product.md)
- [Overview](https://docs.salesbricks.com/quickstart-guide/products-plans-bricks/overview.md)
- [Renewals Management](https://docs.salesbricks.com/renewals/renewals-management.md)
- [Pricing Display](https://docs.salesbricks.com/settings/finance/pricing-display.md)


## Optional

- [Knowledge Base](https://support.salesbricks.com)