{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/reference/register-stamps","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/reference/register-stamps","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/reference/register-stamps","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Register Free Stamps Account","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":"register-free-stamps-account","__idx":0},"children":["Register Free Stamps Account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every ShipStation API account receives a Free Stamps.com account which gives you deep discounts with USPS. In this step, we'll guide you through registering your free account and passing billing information to Stamps.com."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WARNING:"]}," ","You cannot link your accounts to the public test account, you'll need to use your own API key for testing."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"initial-registration","__idx":1},"children":["Initial Registration"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request","__idx":2},"children":["Example Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v1/registration/stamps_com"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/registration/stamps_com HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"nickname\": \"My Stamps.com account\",\n  \"email\": \"john.doe@example.com\",\n  \"agree_to_carrier_terms\" : true,\n  \"address\": {\n    \"name\": \"John Doe\",\n    \"phone\": \"111-111-1111\",\n    \"company_name\": \"Example Corp.\",\n    \"address_line1\": \"4009 Marathon Blvd\",\n    \"address_line2\": \"Suite 300\",\n    \"city_locality\": \"Austin\",\n    \"state_province\": \"TX\",\n    \"postal_code\": \"78756\",\n    \"country_code\": \"US\",\n    \"address_residential_indicator\": \"no\"\n  },\n  \"credit_card\": {\n    \"name\": \"my credit card\",\n    \"number\": \"4111111111111111\",\n    \"type\": \"Visa\",\n    \"expiration_year\": \"2025\",\n    \"expiration_month\": \"07\"\n  }\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All fields are required, except for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address_line2"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["company_name"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-response","__idx":3},"children":["Example Response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"carrier_id\": \"se-123890\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"verify-your-stampscom-account","__idx":4},"children":["Verify your Stamps.com account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After you have finished the initial step of registering your Stamps.com account, you will need to complete your registration via phone verification."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Please use the following endpoints."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-1","__idx":5},"children":["Example Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v1/connections/carriers/stamps_com/:carrier_id/verification"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["INFO:"]}," ","Only sms verification supported initially"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/connections/carriers/stamps_com/:carrier_id/verification HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n\t\"phone\": \"5121112222\",\n\t\"verification_type\": \"sms\"\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-response-1","__idx":6},"children":["Example Response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n\t\"phone\": \"5121112222\",\n\t\"verification_id\": \"vfn_base58encodedguid\",\n\t\"verification_method\": \"sms/voice\",\n\t\"status\" : \"unverified\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You should receive a text message with your verification code. Take that and your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verification_id"]}," and put it in the"," ","payload of the following call."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-2","__idx":7},"children":["Example Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PUT /v1/connections/carriers/stamps_com/:carrier_id/verification/:verification_id"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PUT /v1/connections/carriers/stamps_com/:carrier_id/verification/:verification_id HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n\t\"verification_code\": \"__verification_code_goes_here__\"\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-response-2","__idx":8},"children":["Example Response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n\t\"phone\": \"5121112222\",\n\t\"verification_id\": \"__verification_id_goes_here__\",\n\t\"verification_method\": \"sms\",\n\t\"status\" : \"verified\"\n}\n"},"children":[]}]},"headings":[{"value":"Register Free Stamps Account","id":"register-free-stamps-account","depth":1},{"value":"Initial Registration","id":"initial-registration","depth":2},{"value":"Example Request","id":"example-request","depth":3},{"value":"Example Response","id":"example-response","depth":3},{"value":"Verify your Stamps.com account","id":"verify-your-stampscom-account","depth":2},{"value":"Example Request","id":"example-request-1","depth":3},{"value":"Example Response","id":"example-response-1","depth":3},{"value":"Example Request","id":"example-request-2","depth":3},{"value":"Example Response","id":"example-response-2","depth":3}],"frontmatter":{"seo":{"title":"Register Free Stamps Account"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/reference/register-stamps","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}