Private preview of the new site. Not live.

legal.acceptShopTerms

The shop owner, on the hosted shop terms page, ticks the box and accepts the current Terms of Service for the shop (accept_terms_version). Records the time, version, person, IP address and browser.

WhoHosted page only (a person does it in the browser)
RESTPOST /v1/legal/shop-terms/accept
MCP toolNot an MCP tool
Writesyes, send an Idempotency-Key
AreaSign-in and agent access

When to use it

To start a new shop for someone, call shops.signUp once with accept_terms true, the shop name, the jurisdiction and the owner's name and email. That accepts the Terms of Service for the shop.

What to tell the owner

Send the person the link. They finish this step themselves on the page; you never do it for them.

Input

FieldTypeRequired
shop_idstringyes
accept_terms_versionstringyes

Example

POST https://doingwork.work/v1/legal/shop-terms/accept
content-type: application/json
Idempotency-Key: 3f1c...

{
  "shop_id": "00000000-0000-4000-8000-000000000000",
  "accept_terms_version": "..."
}

Output

FieldTypeAlways there
shop_idstringyes
shopstringyes
current_versionstringyes
terms_urlstringyes
owner_accepted_currentbooleanyes
owner_accepted_at['string', 'null']yes
terms_emailed_at['string', 'null']yes
opt_out_window_start['string', 'null']yes
opt_out_deadline['string', 'null']yes
opt_out_openbooleanyes
opted_outbooleanyes
opted_out_at['string', 'null']yes
opted_out_by['string', 'null']yes
page_urlstringyes
acceptance_idstringyes
{
  "shop_id": "00000000-0000-4000-8000-000000000000",
  "shop": "...",
  "current_version": "...",
  "terms_url": "...",
  "owner_accepted_current": true,
  "owner_accepted_at": "...",
  "terms_emailed_at": "...",
  "opt_out_window_start": "...",
  "opt_out_deadline": "...",
  "opt_out_open": true,
  "opted_out": true,
  "opted_out_at": "...",
  "opted_out_by": "...",
  "page_url": "...",
  "acceptance_id": "00000000-0000-4000-8000-000000000000"
}

Errors

CodeStatusWhat to do
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.