Update Tax Exemption Certificate
PUT/api/tax-exemption-certificates/:certificate
Edit a certificate that is still pending review. Send only the fields to change; omitted fields keep their current values. Sending states replaces the full list of covered states. Once a certificate is approved, rejected or revoked it can no longer be edited — renew it instead (422).
customers:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Accepts every field of Create Customer Tax Exemption Certificate except file and approve_now (use Replace Tax Exemption Certificate Document and Approve Tax Exemption Certificate). Send an empty string to clear an optional field.
Fields:
certificate_number(string, required, max 100)exemption_type(required):resale,nonprofit,government,manufacturing,agricultural,otherform_type(required):state_specific(a state's own form),sst(Streamlined Sales Tax multistate),mtc(MTC uniform),otherform_code(string, optional, max 60) — the form's own code, e.g.01-339orDR-13issued_on(dateY-m-d, optional)expires_on(dateY-m-d, optional, on or afterissued_on)expiry_rule(required):fixed_date(expires onexpires_on),annual(renews every year),never,lapse_after_inactivity(lapses after 12 months without a purchase)states— the US state codes the certificate covers (at least one; two-letter codes, e.g.TX,FL,DC). In multipart requests sendstates[]once per state, or one comma-separatedstatesvalue.external_url(URL, optional, max 2048) — a link to the certificate held elsewhere, instead of or as well as a filenotes(string, optional, max 5000)verification_status(optional):pending,verified,mismatch,unverifiable,manual_check_needed,no_certificate,not_applicable— the outcome of a state registry lookup you ran yourselfverification_payload(JSON string, optional) — the raw lookup result to keep alongside it
Combination rules (422 on violation): the MTC uniform certificate (form_type: mtc) can only be used for resale; Maryland, Hawaii and the District of Columbia (MD, HI, DC) accept no multistate (sst / mtc) certificate — ask for the state's own form.
Authentication: Requires Bearer token with the customers:write scope. Permission: customers.update.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.