> ## Documentation Index
> Fetch the complete documentation index at: https://sendcloud.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# API user flows

Here we outline common user flows when using the Sendcloud APIs.

For an explanation of the terms used, visit the [Glossary](/docs/getting-started/glossary/).

## API v3 user flows

### Standard shipment creation flow (Shipments API v3)

<img src="https://mintcdn.com/sendcloud/0MBToV2_OXBEakve/images/docs/user-flows/008-standard-shipment-flow.png?fit=max&auto=format&n=0MBToV2_OXBEakve&q=85&s=34342af159a44d6e0329b15f97c3a676" alt="Diagram showing suggested API usage for standard shipment creation scenarios" width="2848" height="2791" data-path="images/docs/user-flows/008-standard-shipment-flow.png" />

### Shipping orders from E-commerce platforms

<img src="https://mintcdn.com/sendcloud/xX2cm_mSwg7brSo3/images/docs/user-flows/003-ship-from-ecommerce-004.png?fit=max&auto=format&n=xX2cm_mSwg7brSo3&q=85&s=4d761a00fb72a63daac4195e6db75599" alt="Diagram showing suggested API usage when shipping from an e-commerce platform" width="3072" height="2893" data-path="images/docs/user-flows/003-ship-from-ecommerce-004.png" />

### Shipping a parcel as a white-label product in the marketplace

<img src="https://mintcdn.com/sendcloud/xX2cm_mSwg7brSo3/images/docs/user-flows/006-ship-white-label-001.png?fit=max&auto=format&n=xX2cm_mSwg7brSo3&q=85&s=e24fc11a445aec04f3ce51343b9bd66b" alt="Diagram showing suggested API usage to ship a white-label parcel in the marketplace" width="3136" height="2226" data-path="images/docs/user-flows/006-ship-white-label-001.png" />

### Announcing a multicollo parcel

<img src="https://mintcdn.com/sendcloud/xX2cm_mSwg7brSo3/images/docs/user-flows/007-ship-multicollo-001.png?fit=max&auto=format&n=xX2cm_mSwg7brSo3&q=85&s=53304609e910cbbdb5d9b45a9185fe98" alt="Diagram showing suggested API usage to announce a multicollo parcel" width="3068" height="1995" data-path="images/docs/user-flows/007-ship-multicollo-001.png" />

### Setting up event subscriptions

To start receiving real-time parcel event notifications via the [Event Subscriptions API](/api/v3/event-subscriptions/index) (BETA):

1. **Create a connection** — define where events should be delivered (e.g. a webhook URL or Klaviyo integration) using the [Create a connection](/api/v3/event-subscriptions/create-a-connection) endpoint.
2. **Create a subscription** — specify which events to listen for and link them to your connection using the [Create a subscription](/api/v3/event-subscriptions/create-a-subscription) endpoint.
3. **Test your setup** — verify that events are delivered correctly by using the [Test event delivery](/api/v3/event-subscriptions/test-event-delivery) (`/broadcast/test/{subscription_id}`) endpoint.

## API v2 user flows

### Shipping a parcel to an address

<img src="https://mintcdn.com/sendcloud/xX2cm_mSwg7brSo3/images/docs/user-flows/001-ship-a-parcel-001.png?fit=max&auto=format&n=xX2cm_mSwg7brSo3&q=85&s=04947e874ca48055cfe3293b9c8a45f3" alt="Diagram showing suggested API usage to ship a parcel to an address" width="3138" height="2032" data-path="images/docs/user-flows/001-ship-a-parcel-001.png" />

### Shipping to a service point

<img src="https://mintcdn.com/sendcloud/xX2cm_mSwg7brSo3/images/docs/user-flows/002-ship-to-service-point-001.png?fit=max&auto=format&n=xX2cm_mSwg7brSo3&q=85&s=ceb6304370ee203ba388f485068cbec8" alt="Diagram showing suggested API usage to ship a parcel to a service point" width="3128" height="2043" data-path="images/docs/user-flows/002-ship-to-service-point-001.png" />

### Shipping a parcel using shipping rules

<img src="https://mintcdn.com/sendcloud/xX2cm_mSwg7brSo3/images/docs/user-flows/004-ship-with-rules-001.png?fit=max&auto=format&n=xX2cm_mSwg7brSo3&q=85&s=bf97895cc0e3a1a6742a80950d38d144" alt="Diagram showing suggested API usage to ship a parcel using shipping rules" width="3136" height="2161" data-path="images/docs/user-flows/004-ship-with-rules-001.png" />

### Setting up tracking

<img src="https://mintcdn.com/sendcloud/xX2cm_mSwg7brSo3/images/docs/user-flows/005-set-up-tracking-001.png?fit=max&auto=format&n=xX2cm_mSwg7brSo3&q=85&s=a1d8ade2361b58b2afc1fcf17d3d97ab" alt="Diagram showing suggested API usage to set up tracking" width="3136" height="1577" data-path="images/docs/user-flows/005-set-up-tracking-001.png" />