Sender addresses

A sender address is required information when creating a shipping label. It specifies a ‘ship from’ address to indicate where a parcel came from, and where it should be returned to in the event that something goes wrong.

Sender addresses are configured in your account settings through the Sendcloud panel, and can then be used to specify a ship from location, or a ship to location for returns, when you interact with our APIs.

Sender addresses correlate with the type of methods that you can retrieve when you make an API call to get Shipping rates or Choose a shipping method.

Default sender addresses

Sendcloud allows you to store multiple sender addresses in your account details, but one address must always be marked as default.

  • Whenever you Create a parcel without specifying a sender address id, your default address will be automatically used to create your label
  • In turn, the brand associated with your default sender address is the one that will be assigned to any parcels you create.

Ship from a different sender address location

If you have multiple sender addresses, you can specify a different sender address id to ship a parcel from a different location.

You can retrieve the id for each of your sender addresses my making a GET request to the Get sender addresses endpoint.

Retrieve your configured Sender addreseses

The following GET endpoint will retrieve your configured sender addresses

 1curl --location -g --request GET ''
 4  "sender_addresses": [
 5    {
 6      "id": 2,
 7      "company_name": "French Company",
 8      "contact_name": "Marie Doe",
 9      "email": "",
10      "telephone": "",
11      "street": "Rue Villiers de l'Isle Adam",
12      "house_number": "33",
13      "postal_box": "",
14      "postal_code": "35000",
15      "city": "Rennes",
16      "country": "FR",
17      "vat_number": "NL123456789B01",
18      "coc_number": "NL12345678",
19      "eori_number": "NL123456789",
20      "brand_id": 1,
21    },
22    {
23      "id": 1,
24      "company_name": "Sendcloud",
25      "contact_name": "John Doe",
26      "email": "",
27      "telephone": "+31626262626",
28      "street": "Bogert",
29      "house_number": "115",
30      "postal_box": "",
31      "postal_code": "5642 CV",
32      "city": "Eindhoven",
33      "country": "NL",
34      "vat_number": "NL123456789B01",
35      "coc_number": "NL12345678",
36      "eori_number": "NL123456789",
37      "brand_id": 2,
38    }
39  ]

In this example, two different addresses are stored to this account information, each with its own linked brand.

  • To ship a parcel from our French store location, we can specify the id for this sender address in the sender_address field when you make a POST request to the Create a parcel endpoint.
  • To see shipping methods applicable for parcels shipping from France, you should specify the sender_address id of your secondary location when you make a GET request to the Get shipping methods endpoint.

Automate your ‘ship from’ location with shipping rules

You can make use of Shipping rules to automatically create parcels from a specific sender address, based on pre-defined conditions.

You can configure shipping rules to automatically ship parcels from a specific sender address based on criteria such as from_country, to_country and integration, plus many more.

When properly configured, shipping rules interact with parcels created through the API to remove much of the manual decision making involved in choosing a sender address address per parcel.

You can find more information about creating and applying shipping rules in our documentation
Go to top