Skip to main content

Bulk Request Tax Exemption Certificate Renewals

POST 

/api/tax-exemption-certificates/request-renewal

Email each selected certificate's customer asking for a new certificate (sent to the customer's billing email, else their email). Up to 200 certificate ids per call; duplicates are ignored. Rate limited to 30 requests per minute.

Required scope: customers:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

A certificate is skipped — and listed in skipped with a reason — when it does not exist (not_found), can no longer be renewed because it is rejected, revoked or superseded (not_renewable), was already asked about in the last 7 days (recently_requested), its customer has no valid email (no_email), or the renewal request email template is switched off in Settings → Email Templates (template_off). The email is the tenant's editable tax_exemption_renewal_request template. Each sent request stamps the certificate's renewal_requested_at.

Body: ids (array of integer certificate ids, required, 1–200).

Authentication: Requires Bearer token with the customers:write scope. Permission: customers.update.

Request​

Responses​

OK

Response Headers
    Content-Type