# 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.
- [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 current subscription state](https://docs.salesbricks.com/api-reference/subscriptions/get-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.
- [Get pricing for a subscription](https://docs.salesbricks.com/api-reference/subscriptions/get-pricing-for-a-subscription.md): Get pricing for a subscription including the billing schedule and grand total for the subscription.
- [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 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.
- [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.
- [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.
- [Updates a subscription](https://docs.salesbricks.com/api-reference/subscriptions/updates-a-subscription.md): Updates a subscription for a customer.
- [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 set either a prorated gauge or 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)