Site Logo

🎉 ShipEngine is becoming ShipStation API 🎉

Over the next few months you'll notice the ShipEngine website, documentation portal, and dashboard being rebranded as ShipStation API. For our ShipEngine customers, you don't need to take any action or change any of your integrations in any way. All endpoints will remain the same and continue to function as they always have.

To learn more about what's coming, review our New ShipStation API page.

Create Tags

Tags are simple text-based flags or identifiers that you can add to shipments. Adding tags to shipments can help you query shipments later. Tags can be a simple label, like Guaranteed_Overnight or Fragile, whatever you need to help you in your workflow.

You can create the tags you wish to use in advance and then add tags to your shipments. However, if you tag a shipment with a tag value that doesn't yet exist, we'll make the tag for you at the same time.

Example Request & Response

In this example, we're creating a tag with the value east_warehouse. We could then add this tag to any shipment we know will ship from that warehouse.

POST /v1/tags/:tag_name

1
2
3
4
POST /v1/tags/east_warehouse HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json

Response

1
2
3
{
"name": "east_warehouse"
}