Create Merchant

> **Private Preview** — Access by request only. The API surface may change before general availability. Contact support@zip.tax for access. Creates a new merchant under the authenticated account. The integrator supplies an external `id`; the API returns a server-issued `merchantId` (UUID) to use in subsequent calls.

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

Creates a new merchant under the authenticated account. The integrator supplies an external id; the API returns a server-issued merchantId (UUID) to use in subsequent calls.

Authentication

X-API-KEYstring

API Key authentication via header

Request

This endpoint expects an object.

namestringRequired

Merchant display name

idstringRequired

External identifier for the merchant (integrator-supplied)

contact_firststringOptional

Primary contact first name

contact_laststringOptional

Primary contact last name

contact_emailstringOptionalformat: "email"

Primary contact email

is_txcbooleanOptional

Whether the merchant uses TaxCloud

Response

Created

statusstring

Operation status

messagestring

Human-readable result message

merchantIdstringformat: "uuid"

Server-issued UUID of the affected merchant

Errors

400

Create Merchant Request Bad Request Error

401

Create Merchant Request Unauthorized Error

403

Create Merchant Request Forbidden Error

409

Create Merchant Request Conflict Error

500

Create Merchant Request Internal Server Error

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

Creates a new merchant under the authenticated account. The integrator supplies an external id; the API returns a server-issued merchantId (UUID) to use in subsequent calls.

API Key authentication via header

This endpoint expects an object.

Merchant display name

External identifier for the merchant (integrator-supplied)

Primary contact first name

Primary contact last name

Primary contact email

Whether the merchant uses TaxCloud

Human-readable result message

Server-issued UUID of the affected merchant

$	curl -X POST https://api.zip-tax.com/merchant/create \
>	-H "X-API-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "name",
>	"id": "id"
>	}'

$	curl -X POST https://api.zip-tax.com/merchant/create \
>	-H "X-API-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "name",
>	"id": "id"
>	}'

1	{
2	"status": "status",
3	"message": "message",
4	"merchantId": "merchantId"
5	}