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.