> ## Documentation Index > Fetch the complete documentation index at: https://docs.redbark.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a rule > Up to 20 rules per ruleset; new rules go last. ## OpenAPI ````yaml /openapi/v2.json post /rulesets/{id}/rules openapi: 3.1.0 info: title: Redbark API version: 2026-10-01.wattle description: >- Everything a user can do in the dashboard, by API key. Send `Redbark-Version` on every request; see the conventions guide for ids, lists, errors and idempotency. servers: - url: https://api.redbark.com/v2 security: - Bearer: [] RedbarkVersion: [] tags: - name: Account description: The authenticated account, its plan and the key in use. - name: API keys description: Create, scope, rotate and revoke API keys. - name: Connections description: Linked banks and brokerages, and their lifecycle. - name: Consents description: Open Banking consents behind each connection. - name: Accounts description: Bank and brokerage accounts, live balances and details. - name: Transactions description: Transactions read live from the provider. - name: Holdings description: Brokerage positions. - name: Trades description: Brokerage trade history. - name: Categories description: The category taxonomy and provider categories. - name: Syncs description: Syncs from accounts to destinations. - name: Sync runs description: Individual sync executions. - name: Rules description: Rulesets and rules that transform transactions during a sync. - name: Destinations description: 'Where synced data lands: Sheets, Airtable, Notion, YNAB, webhooks.' - name: Link sessions description: Hosted flows that connect a bank or brokerage. - name: Destination links description: Hosted flows that authorise a destination. - name: Institutions description: Banks available to link. - name: Event destinations description: Endpoints that receive signed events. - name: Events description: What happened, and redelivery. paths: /rulesets/{id}/rules: post: tags: - Rules summary: Create a rule description: Up to 20 rules per ruleset; new rules go last. operationId: create_rule parameters: - schema: type: string description: The id of the object. example: rset_6Kp8Lm1nQr3sTu5vWx7yZa required: true description: The id of the object. name: id in: path requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateRule' responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/Rule' '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Key lacks a scope, plan lacks the feature, or IP not allowed content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: No such resource content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: State conflict or Idempotency-Key conflict content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Rate limited; see Retry-After content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Internal error; quote request_id to support content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: CreateRule: type: object properties: name: type: string minLength: 1 maxLength: 80 conditions: type: object properties: groups: type: array items: type: object properties: conditions: type: array items: type: object properties: field: type: string enum: - merchantName - description - amount - direction - category - class - accountId - reference operator: type: string enum: - contains - does_not_contain - equals - starts_with - gt - lt - eq - between - is - is_not - is_in - is_not_in value: anyOf: - type: string minLength: 1 maxLength: 200 - type: array items: type: string minLength: 1 maxLength: 200 minItems: 1 maxItems: 20 required: - field - operator - value minItems: 1 maxItems: 10 required: - conditions minItems: 1 maxItems: 10 required: - groups action: oneOf: - type: object properties: type: type: string enum: - skip required: - type - type: object properties: type: type: string enum: - email required: - type - type: object properties: type: type: string enum: - set_category value: type: string minLength: 1 maxLength: 200 required: - type - value - type: object properties: type: type: string enum: - set_merchant value: type: string minLength: 1 maxLength: 200 required: - type - value enabled: type: boolean metadata: type: object additionalProperties: type: - string - 'null' maxLength: 500 description: Up to 50 string pairs. Set a key to null to unset it. required: - name - conditions - action Rule: type: object properties: id: type: string example: rule_2Ab4Cd6eFg8hJk0lMn2oPq object: type: string enum: - rule ruleset: type: string name: type: string position: type: integer enabled: type: boolean conditions: type: object additionalProperties: {} description: >- Groups of conditions (OR across groups, AND within). See the rules guide. action: type: object additionalProperties: {} description: '{ type: "skip" | "email" | "set_category" | "set_merchant", value? }' metadata: type: - object - 'null' additionalProperties: type: string maxLength: 500 description: Up to 50 string pairs. Set a key to null in an update to unset it. livemode: type: boolean created: type: string format: date-time example: '2026-08-21T09:30:00.000Z' updated: type: string format: date-time example: '2026-08-21T09:30:00.000Z' required: - id - object - ruleset - name - position - enabled - conditions - action - metadata - livemode - created - updated Error: type: object properties: error: type: object properties: type: type: string enum: - invalid_request_error - authentication_error - permission_error - rate_limit_error - idempotency_error - upstream_error - api_error code: type: string message: type: string param: type: - string - 'null' doc_url: type: string request_id: type: string required: - type - code - message - param - doc_url - request_id required: - error securitySchemes: Bearer: type: http scheme: bearer bearerFormat: API key description: 'Authorization: Bearer rbk_live_...' RedbarkVersion: type: apiKey in: header name: Redbark-Version description: >- The API release your integration is built against, e.g. 2026-10-01.wattle. Required on every request. ````