Framme

Place & fulfil an order

When a recipient orders in your own storefront, submit the order to Framme and we fulfil it. An order references a campaign, the items and their quantities, and where to ship.

Create the order

curl -X POST https://api.development.platform.framme.com/public/v1/store/orders \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_id": "$CAMPAIGN_ID",
    "items": [
      { "product_id": "prod_123", "variant_id": "var_M", "quantity": 2 }
    ],
    "shipping_address": {
      "first_name": "Alex",
      "last_name": "Kim",
      "email": "alex@example.com",
      "street_address": "12 Market St",
      "postal_code": "00100",
      "city": "Helsinki",
      "country": "FI"
    }
  }'

campaign_id, items and shipping_address are required. Each item needs a product_id and quantity; add variant_id for sized products. On the address, phone, state and apt_suite are optional.

If the campaign defines a custom checkout field, include custom_checkout_field_value — the order is rejected without it.