> ## Documentation Index > Fetch the complete documentation index at: https://docs.yorlet.com/llms.txt > Use this file to discover all available pages before exploring further. # Create an account collection subscription > Creates a new account collection subscription. ## OpenAPI ````yaml openapi-owners.json POST /v1/account_collection_subscriptions openapi: 3.1.0 info: title: Yorlet Owners API description: APIs for managing owner payouts, payment runs, transfers, and tax forms. version: 1.0.0 servers: - url: https://api.yorlet.com description: Production - url: https://api.yorlet.io description: Sandbox security: [] paths: /v1/account_collection_subscriptions: post: tags: - Account Collection Subscriptions summary: Create an account collection subscription description: Creates a new account collection subscription. operationId: account_collection_subscriptions_create requestBody: content: application/json: schema: type: object properties: account_collection_data: type: object properties: amount: type: integer minimum: 1 description: >- A positive integer representing the amount of the account collection, in the smallest currency unit. currency: type: string enum: - gbp - usd - eur - sek description: >- Three-letter ISO currency code, in lowercase. Must be a supported currency. example: gbp description: type: string description: >- An arbitrary string attached to the object. Often useful for displaying to users. destination: type: string description: >- The ID of the destination owner the collected funds are sent to. expense: type: object properties: code: type: string enum: - compliance - council_tax - ground_rent - insurance - maintenance - utilities - other description: The category code for the expense. description: type: string description: Further description of the expense. required: - code description: >- Details about the expense being collected. Required when `type` is `expense`. fee: type: object properties: code: type: string enum: - management_fee - tenant_find_fee - renewal_fee - rent_review_fee description: The category code for the fee. discount: type: number minimum: 0 maximum: 100 description: The discount applied to the fee, as a percentage. required: - code description: >- Details about the fee being collected. Required when `type` is `fee`. tax_behavior: type: string enum: - exclusive - inclusive description: How the tax is computed in relation to the amount. tax_percent: type: number minimum: 0 maximum: 100 description: The tax percentage to apply to the account collection. type: type: string enum: - expense - fee - service_charge - non_resident_tax description: The type of the account collection. unit: type: string description: The ID of the unit the account collection is for. workspace: type: string description: The workspace the resulting collection should belong to. required: - amount - currency - description - type description: >- The data used to create account collections on each billing cycle. billing_cycles: type: integer minimum: 0 description: >- The total number of billing cycles the subscription runs for. Use 0 for unlimited. interval: type: string enum: - month - week description: The billing interval for the subscription. interval_count: type: integer minimum: 1 description: The number of intervals between each billing cycle. metadata: type: - object - 'null' additionalProperties: type: string description: >- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. owner: type: string description: The ID of the owner to create the subscription for. start_date: type: integer description: The start date of the subscription. required: - account_collection_data - billing_cycles - interval - interval_count - owner responses: '200': description: >- Returns the account collection subscription object if the request succeeded. content: application/json: schema: type: object properties: id: type: string description: Unique identifier for the object. created: type: number description: >- Time at which the object was created. Measured in seconds since the Unix epoch. account: type: string description: >- The account that the object belongs to. Only returned if the request is made with a valid Yorlet-Context header. deleted: type: boolean default: false description: Only returned if the object has been deleted. object: type: string enum: - account_collection_subscription account_collection_data: type: object properties: amount: type: integer minimum: 1 description: >- A positive integer representing the amount of the account collection, in the smallest currency unit. currency: type: string enum: - gbp - usd - eur - sek description: >- Three-letter ISO currency code, in lowercase. Must be a supported currency. example: gbp description: type: string description: >- An arbitrary string attached to the object. Often useful for displaying to users. destination: type: string description: >- The ID of the destination owner the collected funds are sent to. expense: type: object properties: code: type: string enum: - compliance - council_tax - ground_rent - insurance - maintenance - utilities - other description: The category code for the expense. description: type: string description: Further description of the expense. required: - code description: >- Details about the expense being collected. Required when `type` is `expense`. fee: type: object properties: code: type: string enum: - management_fee - tenant_find_fee - renewal_fee - rent_review_fee description: The category code for the fee. discount: type: number minimum: 0 maximum: 100 description: The discount applied to the fee, as a percentage. required: - code description: >- Details about the fee being collected. Required when `type` is `fee`. tax_behavior: type: string enum: - exclusive - inclusive description: How the tax is computed in relation to the amount. tax_percent: type: number minimum: 0 maximum: 100 description: The tax percentage to apply to the account collection. type: type: string enum: - expense - fee - service_charge - non_resident_tax description: The type of the account collection. unit: type: string description: The ID of the unit the account collection is for. workspace: type: string description: >- The workspace the resulting collection should belong to. required: - amount - currency - description - type description: >- The data used to create account collections on each billing cycle. billing_cycles: type: integer description: >- The total number of billing cycles the subscription runs for. Use 0 for unlimited. billing_cycles_count: type: integer default: 0 description: The number of billing cycles that have been processed. interval: type: string enum: - month - week description: The billing interval for the subscription. interval_count: type: integer description: The number of intervals between each billing cycle. last_account_collection_error: type: - object - 'null' properties: message: type: string description: The message of the last account collection error. type: type: string description: The type of the last account collection error. required: - message - type description: >- The most recent error encountered when generating an account collection. metadata: type: - object - 'null' additionalProperties: type: string description: >- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. next_collection_date: type: - integer - 'null' description: The next date an account collection will be generated. next_period_end: type: - integer - 'null' description: The end of the next billing period. next_period_start: type: - integer - 'null' description: The start of the next billing period. owner: anyOf: - type: string - type: object properties: id: type: string description: Unique identifier for the object. created: type: number description: >- Time at which the object was created. Measured in seconds since the Unix epoch. account: type: string description: >- The account that the object belongs to. Only returned if the request is made with a valid Yorlet-Context header. deleted: type: boolean default: false description: Only returned if the object has been deleted. object: type: string enum: - owner address: type: - object - 'null' properties: line1: type: - string - 'null' line2: type: - string - 'null' city: type: - string - 'null' country: type: - string - 'null' postal_code: type: - string - 'null' state: type: - string - 'null' description: The owner's address. balance: type: number default: 0 description: >- The owner's current balance, in the smallest currency unit. business_type: type: string enum: - individual - company description: The legal type of the owner. client_secret: type: string description: >- A secret token used to authenticate owner-scoped requests, such as generating PDF statements. company: type: - object - 'null' properties: address: type: - object - 'null' properties: line1: type: - string - 'null' line2: type: - string - 'null' city: type: - string - 'null' country: type: - string - 'null' postal_code: type: - string - 'null' state: type: - string - 'null' description: The company's registered address. email: type: - string - 'null' description: The contact email for the company. name: type: - string - 'null' description: Legal name of the company. phone: type: - string - 'null' description: Contact phone number for the company. tax_id: type: - string - 'null' description: The company's tax identification number. vat_id: type: - string - 'null' description: The company's VAT identification number. required: - address - email - name - phone - tax_id - vat_id description: >- Information about the company. Only present when `business_type` is `company`. country: type: - string - 'null' description: >- Two-letter ISO code representing the country of the owner. email: type: - string - 'null' description: The owner's contact email address. external_account: anyOf: - type: object properties: id: type: string description: Unique identifier for the object. created: type: number description: >- Time at which the object was created. Measured in seconds since the Unix epoch. account: type: string description: >- The account that the object belongs to. Only returned if the request is made with a valid Yorlet-Context header. deleted: type: boolean default: false description: >- Only returned if the object has been deleted. object: type: string enum: - external_account available_payout_methods: type: array items: type: string description: >- The payout methods supported by this external account. bank_account: type: object properties: account_holder_name: type: - string - 'null' description: >- The name of the person or business that owns the bank account. account_holder_type: type: - string - 'null' enum: - individual - company - null description: >- The type of entity that holds the account. bank_name: type: - string - 'null' description: >- Name of the bank associated with the account. country: type: string description: >- Two-letter ISO code representing the country the bank account is located in. currency: type: string enum: - aud - eur - gbp - bwp - bnd - cny - hkd - kwd - ils - inr - myr - mur - mxn - mad - nzd - ngn - omr - qar - sar - sgd - sek - thb - try - usd - aed - uyu description: >- Three-letter ISO code for the currency of the bank account. last4: type: - string - 'null' description: >- The last four digits of the bank account number. routing_number: type: - string - 'null' description: >- The routing number, sort code or other country-appropriate institution number for the bank account. swift_bic: type: - string - 'null' description: The SWIFT/BIC code identifying the bank. required: - account_holder_name - account_holder_type - bank_name - country - currency - last4 - routing_number description: >- Bank account details when the external account type is `bank_account`. confirmation_of_payee: type: - object - 'null' properties: status: type: - string - 'null' enum: - awaiting_acknowledgement - confirmed - uninitiated - null description: >- The status of the confirmation of payee check. required: - status description: >- Confirmation of payee status for the external account. metadata: type: - object - 'null' additionalProperties: type: string description: >- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. status: type: string enum: - new - errored description: The status of the external account. type: type: string enum: - bank_account description: The type of the external account. required: - id - created - object - available_payout_methods - confirmation_of_payee - status - type - type: 'null' - type: string description: The external account to which payouts are sent. individual: type: - object - 'null' properties: id: type: string description: Unique identifier for the object. created: type: number description: >- Time at which the object was created. Measured in seconds since the Unix epoch. account: type: string description: >- The account that the object belongs to. Only returned if the request is made with a valid Yorlet-Context header. deleted: type: boolean default: false description: Only returned if the object has been deleted. object: type: string enum: - owner.person address: type: - object - 'null' properties: line1: type: - string - 'null' line2: type: - string - 'null' city: type: - string - 'null' country: type: - string - 'null' postal_code: type: - string - 'null' state: type: - string - 'null' description: The individual's home address. dob: type: - object - 'null' properties: day: type: - integer - 'null' minimum: 1 maximum: 31 month: type: - integer - 'null' minimum: 1 maximum: 12 year: type: - integer - 'null' minimum: 1900 maximum: 9999 required: - day - month - year description: The individual's date of birth. email: type: - string - 'null' format: email description: The individual’s email address. first_name: type: - string - 'null' description: The individual's first name. last_name: type: - string - 'null' description: The individual's last name. metadata: type: - object - 'null' additionalProperties: type: string description: >- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. phone: type: - string - 'null' description: The individual's phone number. relationship: type: object properties: director: type: - boolean - 'null' description: >- Whether the person is a director of the company. executive: type: - boolean - 'null' description: >- Whether the person is an executive of the company. owner: type: - boolean - 'null' description: >- Whether the person is an owner of the company. percent_ownership: type: - number - 'null' minimum: 0 maximum: 100 description: >- The percentage of the company that the person owns. representative: type: - boolean - 'null' description: >- Whether the person is the legal representative of the company. title: type: - string - 'null' description: >- The person's title within the company (e.g., CEO, Director). required: - director - executive - owner - percent_ownership - representative - title description: >- Describes the person's relationship to the company. title: type: - string - 'null' description: The person's title within the company. verification_session: anyOf: - type: string - type: object additionalProperties: {} - type: 'null' description: >- The verification session associated with the person. verification: type: object properties: status: type: - string - 'null' description: The verification status of the person. required: - status description: Verification status information. required: - id - created - object - address - dob - email - first_name - last_name - phone - relationship - title - verification_session - verification description: >- Information about the individual. Only present when `business_type` is `individual`. name: type: - string - 'null' description: Display name of the owner. metadata: type: - object - 'null' additionalProperties: type: string description: >- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. payouts_enabled: type: boolean default: false description: >- Whether the owner is currently able to receive payouts. requirements: type: object properties: currently_due: type: array items: type: string description: >- Fields that must be provided to keep the owner enabled. disabled_reason: type: - string - 'null' description: Reason the owner is disabled, if any. eventually_due: type: array items: type: string description: Fields that must eventually be provided. required: - currently_due - disabled_reason - eventually_due description: Outstanding requirements for the owner. settings: type: object properties: account_collections: type: object properties: platform_fee: type: number default: 0 description: >- The platform fee applied to account collections, in the smallest currency unit. description: Settings related to account collections. maintenance: type: object properties: issue_categories: type: array items: type: string description: >- Maintenance issue categories supported for this owner. issue_preferred_categories: type: array items: type: string description: >- Preferred maintenance issue categories for this owner. required: - issue_categories - issue_preferred_categories description: Maintenance-related settings. payout_receipts: type: object properties: email_cc: type: array items: type: string default: [] description: >- Additional email addresses to CC on payout receipt emails. email_to: type: - string - 'null' description: >- The email address that payout receipts are sent to. send_email: type: boolean default: true description: Whether to send payout receipt emails. statement_descriptor: type: - string - 'null' description: >- The descriptor to display on payout receipt emails. required: - email_to - statement_descriptor description: Settings controlling payout receipt emails. payout_schedule: type: object properties: interval: type: string enum: - daily - weekly - manual - monthly - quarterly - yearly description: How often payouts are sent to the owner. monthly_anchor: type: number default: 31 description: >- The day of the month payouts are sent when `interval` is `monthly`. weekly_anchor: type: number default: 5 description: >- The day of the week payouts are sent when `interval` is `weekly`. required: - interval description: The payout schedule for the owner. payouts: type: object properties: automatic_approval: type: boolean default: false description: >- Whether payouts are automatically approved. instant_payouts: type: boolean default: false description: Whether instant payouts are enabled. negative_payouts: type: boolean default: false description: Whether negative payouts are permitted. transaction_grouping: type: string enum: - all - per_unit description: How transactions are grouped on a payout. required: - transaction_grouping description: Payout-specific settings. required: - account_collections - maintenance - payout_receipts - payout_schedule - payouts description: Configurable settings for the owner. status: type: string enum: - complete - incomplete - disabled - archived description: The current status of the owner. tax_residency: type: - string - 'null' description: >- Two-letter ISO code representing the owner's tax residency country. type: type: string enum: - landlord - leaseholder - platform - supplier description: The type of the owner. required: - id - created - object - address - business_type - client_secret - company - country - email - external_account - individual - name - requirements - settings - status - tax_residency - type description: The owner the subscription is for. start_date: type: - integer - 'null' description: The start date of the subscription. status: type: string enum: - active - canceled - complete - scheduled description: The current status of the subscription. timezone: type: - string - 'null' description: The timezone used to compute billing cycles. required: - id - created - object - account_collection_data - billing_cycles - interval - interval_count - last_account_collection_error - next_collection_date - next_period_end - next_period_start - owner - start_date - status - timezone security: - ApiKeyAuth: [] components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization description: API Key authentication. Use "Bearer YOUR_API_KEY". ````