{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/reference/create-tag","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/reference/create-tag","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/reference/create-tag","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Create Tags","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"create-tags","__idx":0},"children":["Create Tags"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tags are simple text-based flags or identifiers that you can add to shipments. Adding tags to shipments can help you ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/list-shipments"},"children":["query shipments"]}," later. Tags can be a simple label, like ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Guaranteed_Overnight"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Fragile"]},", whatever you need to help you in your workflow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can create the tags you wish to use in advance and then ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/tag-shipment"},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request--response","__idx":1},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, we're creating a tag with the value ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["east_warehouse"]},". We could then add this tag to any shipment we know will ship from that warehouse."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v1/tags/:tag_name"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/tags/east_warehouse HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"name\": \"east_warehouse\"\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Create Tags","id":"create-tags","depth":1},{"value":"Example Request & Response","id":"example-request--response","depth":2}],"frontmatter":{"seo":{"title":"Create Tags"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/reference/create-tag","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}