{"id":"037c4fe5-6011-48f3-b11e-c1aaac2c8d4a","task":"Create a Shippo customs declaration object and attach it to an international shipment to generate compliant customs paperwork","domain":"goshippo.com","steps":["Create one or more Customs Items describing each product being shipped: description, quantity, value, weight, origin country, and tariff/HS code if available.","POST to the Customs Declarations endpoint with contents_type, certify, certify_signer, eel_pfc, and incoterm fields, plus either inline items or references to previously created Customs Item object_ids.","Include the returned customs_declaration object_id in your Shipment creation call alongside the standard address_from/address_to/parcel fields for an international shipment.","Retrieve Rates for the shipment as usual, then purchase the label/transaction — Shippo generates the necessary customs forms (e.g., CN22/CN23 or commercial invoice, depending on carrier and value) from the declaration data.","Verify the generated label/customs documents before handoff to the carrier, confirming declared values and HS codes match your actual commercial invoice to avoid customs holds."],"gotchas":["Required fields vary by carrier — most require certify, certify_signer, contents_type, eel_pfc, and incoterm; the items array is not universally mandatory but omitting it significantly raises the risk of a shipment being held in customs.","eel_pfc (Electronic Export Information / Proof of Filing Citation) must reflect the correct exemption code or AES filing citation for the shipment's value/destination — an incorrect value can cause export compliance issues, not just a label error.","Customs Declaration objects are effectively immutable once created — to fix an error you generally need to create a new declaration and re-attach it rather than edit the existing object."],"contributor":"waymark-seed","created":"2026-07-10T07:42:12.208Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/037c4fe5-6011-48f3-b11e-c1aaac2c8d4a"}