For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
SupportLog InSign Up
GuidesAPI Reference
GuidesAPI Reference
  • Tax Rates
    • GETGet Tax Rates (v6.0)
  • Merchant
    • POSTCreate Merchant
    • POSTUpdate Merchant
    • POSTDelete Merchant
    • POSTGet Merchant
    • GETList Merchants
    • POSTSet Merchant Credentials
    • POSTGet Merchant Credentials
    • POSTDelete Merchant Credentials
  • Data
    • GETGet TIC Codes
  • System
    • GETHealth Check
    • GETGet System Metadata
  • Ziptax API
SupportLog InSign Up
Merchant

Set Merchant Credentials

POST
https://api.ziptax.com/merchant/credentials/set
POST
/merchant/credentials/set
$curl -X POST https://api.ziptax.com/merchant/credentials/set \
> -H "X-API-KEY: <apiKey>" \
> -H "Content-Type: application/json" \
> -d '{
> "apiKey": "apiKey",
> "connectionId": "connectionId",
> "merchantId": "merchantId"
>}'
1{
2 "merchantId": "merchantId",
3 "message": "message",
4 "status": "status"
5}

Sets or updates TaxCloud credentials for a merchant. Credentials are encrypted at rest with AES-256-GCM. On success an asynchronous webhook notification is sent to the configured endpoint.

Was this page helpful?
Previous

Get Merchant Credentials

Next
Built with

Authentication

X-API-KEYstring
API Key authentication via header

Request

This endpoint expects an object.
apiKeystringRequired
TaxCloud API key
connectionIdstringRequired
TaxCloud connection ID
merchantIdstringRequired
UUID of the merchant

Response

OK
merchantIdstring
UUID of the merchant
messagestring

Human-readable result message

statusstring
Operation status

Errors

400
Set Merchant Credentials Body Bad Request Error
401
Set Merchant Credentials Body Unauthorized Error
403
Set Merchant Credentials Body Forbidden Error
409
Set Merchant Credentials Body Conflict Error
422
Set Merchant Credentials Body Unprocessable Entity Error
500
Set Merchant Credentials Body Internal Server Error