create_business
Create a new business entity for a customer in Paddle to manage business information when working with companies rather than individuals.
Instructions
This tool will create a new business for a customer in Paddle.
Business entities hold business information for a customer when working with a business rather than an individual. Customers do not need to have a business to make a purchase, but should if working with a business.
Ensure you have all the information needed before making the call. Don't fabricate, imagine, or infer details and parameter values unless explicitly asked to. If anything is ambiguous, unknown, or unclear, ask the user for clarification or details before you proceed.
If successful, the response includes a copy of the new business entity.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| customerId | Yes | Paddle ID of the customer. | |
| name | Yes | Full name. | |
| companyNumber | No | Company number for this business. | |
| taxIdentifier | No | Tax or VAT Number for this business. | |
| contacts | No | List of contacts related to this business, typically used for sending invoices. | |
| customData | No | Any structured custom key-value data needed outside of Paddle's standard fields. Occasionally used by third-parties. |
Implementation Reference
- src/functions.ts:354-362 (handler)The handler function that executes the create_business tool by calling paddle.businesses.create with the provided customerId and business data.
export const createBusiness = async (paddle: Paddle, params: z.infer<typeof Parameters.createBusinessParameters>) => { try { const { customerId, ...updateData } = params; const business = await paddle.businesses.create(customerId, updateData); return business; } catch (error) { return error; } }; - src/tools.ts:336-347 (registration)Tool registration object defining the 'create_business' method, its name, description prompt, parameters schema, and required actions for the MCP tool.
{ method: "create_business", name: "Create a business for a customer", description: prompts.createBusinessPrompt, parameters: params.createBusinessParameters, actions: { businesses: { write: true, create: true, }, }, }, - src/api.ts:38-38 (registration)Maps the CREATE_BUSINESS constant to the createBusiness handler function in the PaddleAPI toolMap for execution.
[TOOL_METHODS.CREATE_BUSINESS]: funcs.createBusiness, - src/constants.ts:30-30 (registration)Defines the TOOL_METHODS.CREATE_BUSINESS constant string used in tool registrations and mappings.
CREATE_BUSINESS: "create_business", - src/prompts.ts:615-623 (helper)Prompt providing guidance and description for the create_business tool usage.
export const createBusinessPrompt = ` This tool will create a new business for a customer in Paddle. Business entities hold business information for a customer when working with a business rather than an individual. Customers do not need to have a business to make a purchase, but should if working with a business. ${additionalDetailsWarning} If successful, the response includes a copy of the new business entity. `;