Swell · Arazzo Workflow

Swell Onboard Customer and Place Order

Version 1.0.0

Create a customer account and immediately place an order for that account.

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

Provider

swell-io

Workflows

onboard-customer-and-place-order
Create a customer account, then create an order for that account.
Posts a new account and then posts an order referencing the returned account id along with the supplied line items.
2 steps inputs: currency, email, first_name, items, last_name, phone outputs: accountId, orderId, orderNumber
1
createAccountStep
Create the customer account using the supplied email and name.
2
createOrderStep
Create an order tied to the new account with the supplied line items.

Source API Descriptions

Arazzo Workflow Specification

Raw ↑
arazzo: 1.0.1
info:
  title: Swell Onboard Customer and Place Order
  summary: Create a customer account and immediately place an order for that account.
  description: >-
    A core back-office flow for headless commerce. The workflow creates a
    customer account from an email and name, captures the new account id, and
    then creates an order tied to that account with line items and a currency.
    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: accountsApi
  url: ../openapi/swell-io-accounts-api-openapi.yml
  type: openapi
- name: ordersApi
  url: ../openapi/swell-io-orders-api-openapi.yml
  type: openapi
workflows:
- workflowId: onboard-customer-and-place-order
  summary: Create a customer account, then create an order for that account.
  description: >-
    Posts a new account and then posts an order referencing the returned account
    id along with the supplied line items.
  inputs:
    type: object
    required:
    - email
    - items
    properties:
      email:
        type: string
        description: Customer email address, the only required account field.
      first_name:
        type: string
        description: Customer first name.
      last_name:
        type: string
        description: Customer last name.
      phone:
        type: string
        description: Customer phone number.
      currency:
        type: string
        description: ISO 4217 currency code for the order.
      items:
        type: array
        description: Order line items, each typically a product_id and quantity.
        items:
          type: object
  steps:
  - stepId: createAccountStep
    description: Create the customer account using the supplied email and name.
    operationId: createAccount
    requestBody:
      contentType: application/json
      payload:
        email: $inputs.email
        first_name: $inputs.first_name
        last_name: $inputs.last_name
        phone: $inputs.phone
    successCriteria:
    - condition: $statusCode == 201
    outputs:
      accountId: $response.body#/id
      email: $response.body#/email
  - stepId: createOrderStep
    description: >-
      Create an order tied to the new account with the supplied line items.
    operationId: createOrder
    requestBody:
      contentType: application/json
      payload:
        account_id: $steps.createAccountStep.outputs.accountId
        items: $inputs.items
        currency: $inputs.currency
    successCriteria:
    - condition: $statusCode == 201
    outputs:
      orderId: $response.body#/id
      orderNumber: $response.body#/number
      grandTotal: $response.body#/grand_total
  outputs:
    accountId: $steps.createAccountStep.outputs.accountId
    orderId: $steps.createOrderStep.outputs.orderId
    orderNumber: $steps.createOrderStep.outputs.orderNumber

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-onboard-customer-order-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.