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

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.

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.