Swell · Arazzo Workflow

Swell Create Category and Product

Version 1.0.0

Create a category and then create a product assigned to that category.

1 workflow 2 source APIs 1 provider
View Spec View on GitHub CommerceHeadless CommerceAPI-FirstB2CB2BSubscriptionMarketplacesWholesaleStorefrontCheckoutPaymentsCartOrderCatalogInternationalizationArazzoWorkflows

Provider

swell-io

Workflows

create-category-and-product
Create a category, then create a product within it.
Posts a new category and then posts a product that references the returned category id.
2 steps inputs: categoryName, price, productName, sku outputs: categoryId, productId
1
createCategoryStep
Create a new category to group products under.
2
createProductStep
Create a product assigned to the new category via its category_id field.

Source API Descriptions

Arazzo Workflow Specification

Raw ↑
arazzo: 1.0.1
info:
  title: Swell Create Category and Product
  summary: Create a category and then create a product assigned to that category.
  description: >-
    Builds out store taxonomy and catalog in one pass. The workflow first
    creates a category, captures its generated id, and then creates a product
    that references that category through its category_id field so the new
    product is immediately discoverable under the new taxonomy node. Each step
    spells out its request inline so the flow can be read and executed without
    opening the underlying OpenAPI description.
  version: 1.0.0
sourceDescriptions:
- name: categoriesApi
  url: ../openapi/swell-io-categories-api-openapi.yml
  type: openapi
- name: productsApi
  url: ../openapi/swell-io-products-api-openapi.yml
  type: openapi
workflows:
- workflowId: create-category-and-product
  summary: Create a category, then create a product within it.
  description: >-
    Posts a new category and then posts a product that references the returned
    category id.
  inputs:
    type: object
    required:
    - categoryName
    - productName
    - sku
    properties:
      categoryName:
        type: string
        description: Display name of the category to create.
      productName:
        type: string
        description: Display name of the product to create.
      sku:
        type: string
        description: Stock keeping unit for the product.
      price:
        type: number
        description: List price in store currency.
  steps:
  - stepId: createCategoryStep
    description: Create a new category to group products under.
    operationId: createCategory
    requestBody:
      contentType: application/json
      payload:
        name: $inputs.categoryName
    successCriteria:
    - condition: $statusCode == 201
    outputs:
      categoryId: $response.body#/id
  - stepId: createProductStep
    description: >-
      Create a product assigned to the new category via its category_id field.
    operationId: createProduct
    requestBody:
      contentType: application/json
      payload:
        name: $inputs.productName
        sku: $inputs.sku
        price: $inputs.price
        category_id: $steps.createCategoryStep.outputs.categoryId
        active: true
    successCriteria:
    - condition: $statusCode == 201
    outputs:
      productId: $response.body#/id
      categoryId: $response.body#/category_id
  outputs:
    categoryId: $steps.createCategoryStep.outputs.categoryId
    productId: $steps.createProductStep.outputs.productId

Work with this as data

Every workflow here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for arazzo workflows

4 MCP tools reach this
  • find_arazzoBrowse and filter every workflow in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This workflow
curl "https://apis.io/api/v1/arazzo/swell-io-categorize-product-workflow"
All arazzo workflows
curl "https://apis.io/api/v1/arazzo?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.