---
title: "sends an order in a single step.  This is much easier than using other order commands"
method: POST
path: "/orders/singleStepOrder"
tags: ["orders"]
---

# sends an order in a single step.  This is much easier than using other order commands

`POST /orders/singleStepOrder`

Sends an order in one step.  No need to create then process order.  Optionally include a gift card.

## Request body

- object
  - `uid` string, required — The UID of the logged-in user
  - `card_id` integer, required — the id of the card you want to send
  - `denomination_id` integer — Optional. Use if sending a gift card
  - `message` string, required — the full message body. Use '\n' for new lines
  - `font_label` string — the colloquial name of the font, such as 'Fancy Jenna' or 'Casual David'
  - `sender_name` string — the name on the return address
  - `sender_business_name` string — the second line of the return address. Optional.
  - `sender_address1` string — the first address line of the return address
  - `sender_address2` string — the second line of the address, such as suite, apartment, building, etc. Optional
  - `sender_city` string — the city of the sender, to appear in the return address
  - `sender_state` string — the ABBREVIATED state or province of the sender. This is required for US and Canada addresses and optional for all other countries
  - `sender_zip` string — The postal code or zip code of the sender.
  - `sender_country` string — the country of the recipient. Optional and defaults to usa
  - `sender_country_id` integer — alternate way to specify country. Optional and defaults to 1
  - `recipient_name` string — the name on the recipient address
  - `recipient_business_name` string — the second line of the recipient address. Optional.
  - `recipient_address1` string — the first address line of the return address
  - `recipient_address2` string — the second line of the address, such as suite, apartment, building, etc. Optional
  - `recipient_city` string — the city of the recipient, to appear in the address
  - `recipient_state` string — the ABBREVIATED state or province of the recipient. This is required for US and Canada addresses and optional for all other countries
  - `recipient_zip` string — the zip code or postal code of the recipient
  - `recipient_country` string — the country of the recipient. Optional and defaults to usa
  - `recipient_country_id` integer — alternate way to specify country. Optional and defaults to 1
  - `credit_card_id` integer — the credit card id to charge for the order. Currently this is required, even for invoiced accounts, it just won't be charged.

## Response `200`

successful order placement

- object
  - `status` string
  - `response` Order
    - `id` integer — the unique ID of the order
    - `for_free` boolean — if the order was free
    - `date_created` string — the date the order was created
    - `message` string — The actual message of the template
    - `card` Card
      - `id` integer
      - `name` string
      - `cover` string — cover image of card
      - `cover_width` string — the width in px of the cover image
      - `cover_height` string — the height in px of the cover image
      - `price` number — the base price of a card (in USD)
      - `category_id` integer — the associated category id
      - `available_free` integer — 1 for cards that are available free
    - `address_from` Address
      - `id` integer — the internal id of the address at Handwrytten
      - `name` string — the name on the address
      - `business_name` string — the optional business name on the address
      - `address1` string — the first line of the address
      - `address2` string — the second (optional) line of the address
      - `city` string — the city of the address
      - `state` string — the abbreviated state or province of the address
      - `zip` string — the zip or postal code of the address
      - `country` string — the name of the country of the address

---

[API](https://skmtc.dev/swaggerhub/apis/handwrytten-api.md) · [All operations](https://skmtc.dev/swaggerhub/apis/handwrytten-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/swaggerhub/handwrytten-api/revisions/45e7c951cdd6/schema)