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)
  • Account
    • GETGet Account Metrics (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
    • POSTSearch TIC Codes
    • POSTRecommend TIC Codes
    • GETGet TIC Search JSON Schema
  • System
    • GETHealth Check
    • GETGet System Metadata
SupportLog InSign Up
Merchant

Set Merchant Credentials

Beta
POST
https://api.zip-tax.com/merchant/credentials/set
POST
/merchant/credentials/set
$curl -X POST https://api.zip-tax.com/merchant/credentials/set \
>     -H "X-API-KEY: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "merchantId": "merchantId",
>  "apiKey": "apiKey",
>  "connectionId": "connectionId"
>}'
1{
2  "status": "status",
3  "message": "message",
4  "merchantId": "merchantId"
5}
> **Private Preview** — Access by request only. The API surface may change before general availability. Contact support@zip.tax for access. Sets or updates the TaxCloud credentials for a merchant. The caller must own the merchant. Credentials are encrypted at rest with AES-256-GCM.
Was this page helpful?
Previous

Get Merchant Credentials

Next
Built with

Private Preview — Access by request only. The API surface may change before general availability. Contact support@zip.tax for access.

Sets or updates the TaxCloud credentials for a merchant. The caller must own the merchant. Credentials are encrypted at rest with AES-256-GCM.

Authentication

X-API-KEYstring
API Key authentication via header

Request

This endpoint expects an object.
merchantIdstringRequiredformat: "uuid"

Server-issued UUID of the merchant

apiKeystringRequired
TaxCloud API key to associate with the merchant
connectionIdstringRequired
TaxCloud connection ID to associate with the merchant

Response

OK
statusstring
Operation status
messagestring

Human-readable result message

merchantIdstringformat: "uuid"

Server-issued UUID of the affected merchant

Errors

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